@xapp/chat-widget 1.101.0 → 1.103.0

package/dist/index.es.js

@@ -919,6 +919,15 @@ var ActionBarCta = function (_a) {
  * in `_mixins.scss`. Keep this in step with the `mobile()` mixin. XappMedia/chat-widget#1594.
  */
 var MOBILE_MEDIA_QUERY = "(max-width: 640px), (max-height: 480px) and (pointer: coarse)";
+/**
+ * Whether the chat panel renders full-screen right now. False where matchMedia is missing
+ * (jsdom), matching ActionBar's assume-desktop fallback.
+ */
+function isMobileViewport(win) {
+    if (win === void 0) { win = window; }
+    return typeof win.matchMedia === "function" && win.matchMedia(MOBILE_MEDIA_QUERY).matches;
+}
+
 /**
  * ChatWidget.scss sizes the chat panel against this variable. Nothing used to set it, so it always
  * fell back to the hardcoded 80px in the SCSS - and the real mobile bar is taller than that once
@@ -2322,8 +2331,100 @@ function setVisualStatus(status) {
     };
 }
 
-function execute(url, dispatch, visuals, behavior) {
+/**
+ * Carries "this visitor just clicked a link in the chat" across a same-tab navigation.
+ *
+ * Persisted widget state already survives the page load, but it cannot tell a chat link
+ * click from a visitor coming back to the site later. The param can; it is read on arrival
+ * and stripped from the address bar so it is never bookmarked or shared.
+ */
+var CHAT_CONTINUE_PARAM = "xa_chat";
+var CHAT_CONTINUE_VALUE = "resume";
+var CONTINUE_CTA_MESSAGE = "Continue your conversation";
+/**
+ * Marks a link the widget is about to follow in this tab. Only same-origin links: widget
+ * state lives in this origin's localStorage, so the widget on any other origin - a
+ * subdomain included - has no conversation to continue.
+ */
+function withChatContinueParam(url, currentOrigin) {
+    try {
+        var urlObj = new URL(url);
+        if (urlObj.origin !== currentOrigin || urlObj.searchParams.get(CHAT_CONTINUE_PARAM) === CHAT_CONTINUE_VALUE) {
+            return url;
+        }
+        urlObj.searchParams.set(CHAT_CONTINUE_PARAM, CHAT_CONTINUE_VALUE);
+        return urlObj.toString();
+    }
+    catch (_) {
+        return url;
+    }
+}
+/**
+ * True when this page was reached through a chat link. Pure, so it is safe inside a
+ * render-time initializer that React may call twice (StrictMode); strip the param
+ * separately with `stripChatContinueParam`, from an effect.
+ */
+function hasChatContinueParam(win) {
+    if (win === void 0) { win = window; }
+    try {
+        return new URL(win.location.href).searchParams.get(CHAT_CONTINUE_PARAM) === CHAT_CONTINUE_VALUE;
+    }
+    catch (_) {
+        return false;
+    }
+}
+/**
+ * Removes the param from the address bar with replaceState, keeping the rest of the URL
+ * and any SPA history state. A no-op when it is absent, so repeating it is harmless.
+ */
+function stripChatContinueParam(win) {
+    if (win === void 0) { win = window; }
+    try {
+        var url = new URL(win.location.href);
+        if (!url.searchParams.has(CHAT_CONTINUE_PARAM)) {
+            return;
+        }
+        url.searchParams.delete(CHAT_CONTINUE_PARAM);
+        win.history.replaceState(win.history.state, "", url.toString());
+    }
+    catch (_) {
+        // An address bar we cannot rewrite only leaves the param visible.
+    }
+}
+/**
+ * A conversation worth continuing: any message on screen. Join notices do not count - the
+ * MCP connection posts one before the greeting, so a brand-new session has one too.
+ */
+function hasConversation(chats) {
+    return !!(chats === null || chats === void 0 ? void 0 : chats.some(function (chat) { return chat.type === "chat.msg"; }));
+}
+/**
+ * The CTA to show, given whether there is a conversation to go back to.
+ *
+ * With one, the first-visit copy ("Need Help? Click Here") becomes a prompt to continue,
+ * keeping the tenant's timing and styling. A tenant with no CTA gets none on an ordinary
+ * page load; right after a chat link it does, immediately - on mobile that prompt is the
+ * only sign the conversation is still there, because the panel stays closed over the page
+ * they asked for.
+ */
+function resolveCta(cta, options) {
+    var arrivedViaChatLink = options.arrivedViaChatLink;
+    if (!options.hasConversation || (!(cta === null || cta === void 0 ? void 0 : cta.message) && !arrivedViaChatLink)) {
+        return cta;
+    }
+    var immediately = arrivedViaChatLink ? { delay: 0 } : {};
+    var mobile = cta === null || cta === void 0 ? void 0 : cta.mobile;
+    return __assign$1(__assign$1(__assign$1(__assign$1({}, cta), { message: CONTINUE_CTA_MESSAGE }), immediately), (mobile && {
+        mobile: __assign$1(__assign$1(__assign$1({}, mobile), ((typeof mobile.message === "string" || arrivedViaChatLink) && { message: CONTINUE_CTA_MESSAGE })), immediately),
+    }));
+}
+
+/**
+ * @internal Exported for unit testing; use `useOpenUrlCallback`.
+ */
+function executeOpenUrl(url, dispatch, visuals, behavior, isMobile) {
     var _a, _b;
+    if (isMobile === void 0) { isMobile = isMobileViewport(); }
     if (!dispatch || !visuals) {
         throw new Error("OpenUrl: No dispatch and/or visual.");
     }
@@ -2390,12 +2491,23 @@ function execute(url, dispatch, visuals, behavior) {
             window.open(url, "_blank");
             break;
         case "sameWindow":
-            if (!visuals.opened) {
+            // Desktop: the next page reopens the chat beside the content, as before.
+            // Mobile: the panel is full-screen, so reopening it would cover the page they
+            // just asked for. Leave it closed; the param lets that page offer to continue.
+            // Unconditional: callers can hand in a `visuals` captured before the chat opened
+            // (ChatMarkdownMessage's click handler does), and skipping on a stale `opened`
+            // leaves the persisted state open.
+            if (isMobile) {
+                dispatch(setVisualStatus({
+                    opened: false
+                }));
+            }
+            else if (!visuals.opened) {
                 dispatch(setVisualStatus({
                     opened: true
                 }));
             }
-            window.open(url, "_self");
+            window.open(withChatContinueParam(url, window.location.origin), "_self");
             break;
         default:
             throwBadKind$1(type);
@@ -2407,7 +2519,7 @@ function useOpenUrlCallback() {
         if (!behavior) {
             behavior = (env === null || env === void 0 ? void 0 : env.urls) ? resolveUrlPolicy(url, env.urls) : defaultBehavior;
         }
-        execute(url, dispatch, visuals, behavior);
+        executeOpenUrl(url, dispatch, visuals, behavior);
     }, [env]);
 }
 
@@ -4300,6 +4412,10 @@ var MCPChat = /** @class */ (function () {
         this.isInitializingSession = false;
         // Session validation state (silent handshake - no stream dispatch)
         this.isValidatingSession = false;
+        // A conversation is on screen that the server should keep: restored from a previous page,
+        // or confirmed by the server on this one. Sent as `continueConversation`, which also lets
+        // the server resume a session idle longer than its default window.
+        this.conversationOnScreen = false;
         // Tool call tracking for debug mode
         this.currentToolCalls = [];
         this.isReplaying = false;
@@ -4387,8 +4503,12 @@ var MCPChat = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, 4, 5]);
-                        return [4 /*yield*/, this.performSSERequest(this.buildRequestPayload({ resumeSession: true }))];
+                        // With a conversation on screen (e.g. after a same-tab link click), ask the
+                        // server to continue it: without the flag it clears the history and greets.
+                        return [4 /*yield*/, this.performSSERequest(this.buildRequestPayload(__assign$1({ resumeSession: true }, (this.conversationOnScreen && { continueConversation: true }))))];
                     case 2:
+                        // With a conversation on screen (e.g. after a same-tab link click), ask the
+                        // server to continue it: without the flag it clears the history and greets.
                         _a.sent();
                         log("Session validation complete");
                         return [3 /*break*/, 5];
@@ -5068,7 +5188,7 @@ var MCPChat = /** @class */ (function () {
                     return [2 /*return*/];
                 }
                 log("[attemptSSERequest] Sending message: \"".concat(messageText, "\", userId: ").concat(this._userId, ", sessionId: ").concat(this._sessionId));
-                return [2 /*return*/, this.performSSERequest(this.buildRequestPayload({ message: messageText }))];
+                return [2 /*return*/, this.performSSERequest(this.buildRequestPayload(__assign$1({ message: messageText }, (this.conversationOnScreen && { continueConversation: true }))))];
             });
         });
     };
@@ -5150,6 +5270,7 @@ var MCPChat = /** @class */ (function () {
                                     case "connected":
                                         // Connection established
                                         log("[SSE] Connected event received, messageId: ".concat(messageId, ", isReturningUser: ").concat(data.isReturningUser, ", isReplay: ").concat(data.isReplay));
+                                        _this.conversationOnScreen = true;
                                         // Track if this is a replay connection
                                         if (data.isReplay) {
                                             _this.isReplaying = true;
@@ -5185,10 +5306,27 @@ var MCPChat = /** @class */ (function () {
                                         }
                                         _this.startStreamThrottle(bubbleId);
                                         break;
+                                    case "session_resumed":
+                                        // The server continued the conversation: no greeting follows,
+                                        // so adopt the identity without opening a stream bubble.
+                                        log("[SSE] Session resumed, sessionId: ".concat(data.sessionId, ", hasHistory: ").concat(data.hasHistory));
+                                        _this.conversationOnScreen = true;
+                                        if (data.userId) {
+                                            _this._userId = data.userId;
+                                            _this.userIdIsServerAssigned = true;
+                                        }
+                                        if (data.sessionId) {
+                                            _this._sessionId = data.sessionId;
+                                            _this.dispatch(setSessionId(_this._sessionId));
+                                        }
+                                        storeIdentity(data.userId, data.sessionId);
+                                        _this.stopTyping();
+                                        break;
                                     case "session_expired":
                                         // Session no longer exists on server - need to start fresh
                                         log("[SSE] Session expired: ".concat(data.reason || "Session not found"));
                                         // Clear stored session (and lastSeq) but keep userId for returning user identification
+                                        _this.conversationOnScreen = false;
                                         clearStoredSession(_this._sessionId);
                                         _this._sessionId = "";
                                         _this.lastSeq = undefined;
@@ -5439,6 +5577,7 @@ var MCPChat = /** @class */ (function () {
     MCPChat.prototype.setVisitorInfo = function (visitorInfo, sessionId, cb) {
         this.visitorInfo = visitorInfo;
         this._attributes = __assign$1({}, this.visitorInfo.attributes);
+        this.conversationOnScreen = visitorInfo.hasConversation === true;
         // do not set currentUrl if localhost
         var href = new URL(window.location.href);
         if (href === null || href === void 0 ? void 0 : href.host.toLowerCase().startsWith("localhost")) {
@@ -12953,7 +13092,21 @@ var ChatTextMessage = function (props) {
     var wasStreamed = message.wasStreamed;
     var showTail = agentMessage && !props.sibling && !isStreaming && !wasStreamed;
     var hasToolCalls = props.toolCalls && props.toolCalls.length > 0;
-    return (jsxs("div", { className: "chat-msg".concat(isStreaming ? " chat-msg--streaming" : ""), children: [hasToolCalls && (jsx(ToolCallDisplay, { toolCalls: props.toolCalls, debugMode: props.debugMode })), jsx("div", { className: "chat-text-container", children: jsxs(ChatMessageBubble, { owner: agentMessage ? "others" : "mine", hasTail: showTail, children: [jsx("span", { className: "message-sr-only", children: "at " + time + (agentMessage ? (isStreaming ? " the bot is typing" : " the bot said") : " the user said") }), parsedHtml ? (jsx("span", { className: "chat-msg__content", dangerouslySetInnerHTML: { __html: parsedHtml } })) : (jsx("span", { className: "chat-msg__content", children: message.msg.text })), isStreaming && jsx("span", { className: "streaming-cursor", "aria-hidden": "true" })] }) })] }));
+    // Delegated, because the links are inside dangerouslySetInnerHTML. Modified clicks stay
+    // with the browser so ctrl/cmd-click still opens a background tab.
+    var onLinkClick = props.onLinkClick;
+    var handleContentClick = function (ev) {
+        var _a, _b;
+        if (!onLinkClick || ev.metaKey || ev.ctrlKey || ev.shiftKey || ev.altKey) {
+            return;
+        }
+        var link = (_b = (_a = ev.target).closest) === null || _b === void 0 ? void 0 : _b.call(_a, "a");
+        if (link && ev.currentTarget.contains(link)) {
+            ev.preventDefault();
+            onLinkClick(link.href);
+        }
+    };
+    return (jsxs("div", { className: "chat-msg".concat(isStreaming ? " chat-msg--streaming" : ""), children: [hasToolCalls && (jsx(ToolCallDisplay, { toolCalls: props.toolCalls, debugMode: props.debugMode })), jsx("div", { className: "chat-text-container", children: jsxs(ChatMessageBubble, { owner: agentMessage ? "others" : "mine", hasTail: showTail, children: [jsx("span", { className: "message-sr-only", children: "at " + time + (agentMessage ? (isStreaming ? " the bot is typing" : " the bot said") : " the user said") }), parsedHtml ? (jsx("span", { className: "chat-msg__content", onClick: handleContentClick, dangerouslySetInnerHTML: { __html: parsedHtml } })) : (jsx("span", { className: "chat-msg__content", children: message.msg.text })), isStreaming && jsx("span", { className: "streaming-cursor", "aria-hidden": "true" })] }) })] }));
 };
 
 var ChatScheduleWidget = function (props) {
@@ -12996,14 +13149,21 @@ var avaKeys = ["text", "html", "card", "list"];
  * @returns
  */
 var ChatMessage = function (props) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     var middleware = props.messageMiddleware || StandardMiddlewares;
     var chatConfig = useContext(ChatConfigContext);
     // console.log(`########### chatConfig: ${JSON.stringify(chatConfig, null, 2)}`);
     var ctx = props.middlewareContext;
     var user = props.agent;
+    var chatDispatch = useChatDispatch();
+    var visuals = useSelector(function (state) { return state.visuals; });
+    // Text links follow the tenant's URL policy when it set one (utm_source, same-tab
+    // continuation, ...). Tenants without one keep the plain new-tab anchor.
+    var handleTextLinkClick = ((_a = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _a === void 0 ? void 0 : _a.urls) && (ctx === null || ctx === void 0 ? void 0 : ctx.openUrl)
+        ? function (href) { return ctx.openUrl(href, chatDispatch, visuals); }
+        : undefined;
     // Get hideUserInfo from the agent info based on the message sender's nick
-    var agentInfo = (_a = props.agents) === null || _a === void 0 ? void 0 : _a[props.message.user.nick];
+    var agentInfo = (_b = props.agents) === null || _b === void 0 ? void 0 : _b[props.message.user.nick];
     var hideUserInfo = (agentInfo === null || agentInfo === void 0 ? void 0 : agentInfo.hideUserInfo) || false;
     function renderByType() {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
@@ -13022,7 +13182,7 @@ var ChatMessage = function (props) {
                 var debugMode = (_d = (_c = (_b = (_a = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _a === void 0 ? void 0 : _a.connection) === null || _b === void 0 ? void 0 : _b.mcp) === null || _c === void 0 ? void 0 : _c.debugMode) !== null && _d !== void 0 ? _d : false;
                 // Show tool progress with avatar when no text yet, or above text when text exists
                 var showToolProgressWithAvatar = hasToolCalls && !msg.text;
-                return (jsxs(Fragment, { children: [showToolProgressWithAvatar && (jsx(ChatMessagePart, { showAvatar: true, user: user, avatarPosition: (_g = (_f = (_e = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _e === void 0 ? void 0 : _e.theme) === null || _f === void 0 ? void 0 : _f.messages) === null || _g === void 0 ? void 0 : _g.avatarPosition, hideUserInfo: hideUserInfo, isStreaming: true, children: jsx("div", { className: "chat-msg", children: jsx(ToolCallDisplay, { toolCalls: toolCalls, debugMode: debugMode }) }) })), msg.text && (jsx(ChatMessagePart, { showAvatar: avaKey === "text", user: user, avatarPosition: (_k = (_j = (_h = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _h === void 0 ? void 0 : _h.theme) === null || _j === void 0 ? void 0 : _j.messages) === null || _k === void 0 ? void 0 : _k.avatarPosition, hideUserInfo: hideUserInfo, isStreaming: isStreaming_1 || wasStreamed, children: jsx(ChatTextMessage, { message: props.message, sibling: props.sibling, user: user, toolCalls: hasToolCalls ? toolCalls : undefined, debugMode: debugMode }) })), msg.html &&
+                return (jsxs(Fragment, { children: [showToolProgressWithAvatar && (jsx(ChatMessagePart, { showAvatar: true, user: user, avatarPosition: (_g = (_f = (_e = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _e === void 0 ? void 0 : _e.theme) === null || _f === void 0 ? void 0 : _f.messages) === null || _g === void 0 ? void 0 : _g.avatarPosition, hideUserInfo: hideUserInfo, isStreaming: true, children: jsx("div", { className: "chat-msg", children: jsx(ToolCallDisplay, { toolCalls: toolCalls, debugMode: debugMode }) }) })), msg.text && (jsx(ChatMessagePart, { showAvatar: avaKey === "text", user: user, avatarPosition: (_k = (_j = (_h = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _h === void 0 ? void 0 : _h.theme) === null || _j === void 0 ? void 0 : _j.messages) === null || _k === void 0 ? void 0 : _k.avatarPosition, hideUserInfo: hideUserInfo, isStreaming: isStreaming_1 || wasStreamed, children: jsx(ChatTextMessage, { message: props.message, sibling: props.sibling, user: user, toolCalls: hasToolCalls ? toolCalls : undefined, debugMode: debugMode, onLinkClick: handleTextLinkClick }) })), msg.html &&
                             jsx(ChatMessagePart, { showAvatar: avaKey === "html", user: user, avatarPosition: (_o = (_m = (_l = chatConfig === null || chatConfig === void 0 ? void 0 : chatConfig.env) === null || _l === void 0 ? void 0 : _l.theme) === null || _m === void 0 ? void 0 : _m.messages) === null || _o === void 0 ? void 0 : _o.avatarPosition, hideUserInfo: hideUserInfo, children: jsx(ChatMarkdownMessage, { message: props.message, sibling: props.sibling, onOpenUrl: (_p = props.middlewareContext) === null || _p === void 0 ? void 0 : _p.openUrl }) }), msg.displays && middleware && msg.displays.map(function (display, index) {
                             if (display.type === "ScheduleButton") {
                                 return (jsx(ChatScheduleWidget, { minimizeOnClick: props.minimizeOnClick, display: display }, index));
@@ -13046,7 +13206,7 @@ var ChatMessage = function (props) {
     }
     // Don't show timestamp/sources while streaming or if message has no content yet
     var isStreaming = props.message.isStreaming;
-    var hasContent = !!(((_b = props.message.msg) === null || _b === void 0 ? void 0 : _b.text) || ((_c = props.message.msg) === null || _c === void 0 ? void 0 : _c.html));
+    var hasContent = !!(((_c = props.message.msg) === null || _c === void 0 ? void 0 : _c.text) || ((_d = props.message.msg) === null || _d === void 0 ? void 0 : _d.html));
     var showFooter = !isStreaming && hasContent;
     // empty
     return (jsx("div", { className: "chat-msg-container-wrapper ".concat(isAgent(props.message.user.nick) ? "agent" : "visitor", " ").concat(props.sibling ? "sibling" : ""), children: jsxs("div", { className: "chat-msg-container ".concat(getClassName(props.message)), children: [renderByType(), showFooter && renderTimestampAndSources()] }) }));
@@ -13056,9 +13216,6 @@ var ChatMessage = function (props) {
  * value must be like "60m", "2h" etc.
  */
 function convertToSeconds(s) {
-    if (!s) {
-        return 0;
-    }
     var groups = s.match(/(\d+)([dhms]?)/);
     if (!groups) {
         err("Invalid time string: ".concat(s));
@@ -13081,15 +13238,50 @@ function convertToSeconds(s) {
     }
 }
 
-function checkSessionExpiration(duration, lastMessageTimestamp, _lastTimestamp) {
-    var durationMs = convertToSeconds(duration) * 1000;
-    // never if no session duration in config
-    if (!duration) {
+/**
+ * How long a conversation must sit idle, on top of the calendar day changing, before it
+ * expires when the widget config does not say.
+ */
+var DEFAULT_SESSION_EXPIRATION = "4h";
+function isSameLocalDay(a, b) {
+    var dayA = new Date(a);
+    var dayB = new Date(b);
+    return dayA.getFullYear() === dayB.getFullYear()
+        && dayA.getMonth() === dayB.getMonth()
+        && dayA.getDate() === dayB.getDate();
+}
+/**
+ * A conversation expires only when BOTH the visitor's local calendar day has changed since
+ * the last message AND at least `duration` has passed. So a visitor who browses the site
+ * over an afternoon keeps one conversation, and one chatting at 11pm is not greeted afresh
+ * at 1am - but tomorrow's visit starts clean.
+ */
+function checkSessionExpiration(duration, lastMessageTimestamp, _lastTimestamp, now) {
+    if (now === void 0) { now = Date.now(); }
+    if (!lastMessageTimestamp) {
         return false;
     }
-    // TODO: Why? Let's use the time passed since the last message timestamp
-    // return lastTimestamp - lastMessageTimestamp > durationMs;
-    return +new Date() - lastMessageTimestamp > durationMs;
+    var durationMs = convertToSeconds(duration || DEFAULT_SESSION_EXPIRATION) * 1000;
+    return now - lastMessageTimestamp >= durationMs && !isSameLocalDay(lastMessageTimestamp, now);
+}
+
+/**
+ * Whether this page was reached through a same-tab link in the chat, read once on mount.
+ *
+ * The read is pure and the strip runs in an effect. StrictMode calls state initializers
+ * twice in development, and React 18 (still allowed by our peer range) keeps the second
+ * result - which an initializer that also stripped the param would get wrong. React 19
+ * reuses the first result, so the test suite here cannot show that failure.
+ */
+function useArrivedViaChatLink(disabled) {
+    if (disabled === void 0) { disabled = false; }
+    var arrived = useState(function () { return !disabled && hasChatContinueParam(); })[0];
+    useEffect(function () {
+        if (arrived) {
+            stripChatContinueParam();
+        }
+    }, [arrived]);
+    return arrived;
 }
 
 function useExternalScript(url) {
@@ -13210,6 +13402,7 @@ function useGreeting(active) {
     // Handle null context (e.g., in preview mode)
     var isAdmin = (_b = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.env) === null || _a === void 0 ? void 0 : _a.isAdmin) !== null && _b !== void 0 ? _b : false;
     var sessionId = useSelector(function (state) { return state.sessionId; });
+    var conversationOnScreen = useSelector(function (state) { return hasConversation(state.chats); });
     useEffect(function () {
         if (active) {
             if (snapshotRef.current !== curr) {
@@ -13220,7 +13413,8 @@ function useGreeting(active) {
                         visitorId: curr.visitorId,
                         userId: curr.userId,
                         accessToken: curr.accessToken,
-                        attributes: __assign$1(__assign$1({}, curr.attributes), { currentUrl: window.location.href })
+                        attributes: __assign$1(__assign$1({}, curr.attributes), { currentUrl: window.location.href }),
+                        hasConversation: conversationOnScreen
                     }, sessionId));
                     if (!isAdmin) {
                         var timeoutId_1 = setTimeout(function () {
@@ -37076,7 +37270,7 @@ var ChatWidgetConnected = function (props) {
  * Exported for use by StaticChatWidgetContainer to avoid infinite loops.
  */
 var ChatWidgetUI = function (props) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14;
     var innerDispatch = useChatDispatch();
     var dispatch = useChatServerDispatch();
     // Publish the visual viewport's geometry so the panel can size around the soft keyboard.
@@ -37097,14 +37291,27 @@ var ChatWidgetUI = function (props) {
     // Preview mode can be enabled via `preview` prop (recommended) or legacy `mode="preview"`
     var previewMode = props.preview === true || mode === "preview";
     var modeClass = "widget-container--".concat(mode);
-    var canRefresh = (_c = (_b = props.config.header) === null || _b === void 0 ? void 0 : _b.actions) === null || _c === void 0 ? void 0 : _c.refresh;
+    // Reached this page through a link in the chat.
+    var arrivedViaChatLink = useArrivedViaChatLink(previewMode);
+    var conversationOnScreen = hasConversation(chatState.chats);
+    var chatButtonCta = useMemo(function () { var _a; return resolveCta((_a = props.config) === null || _a === void 0 ? void 0 : _a.cta, { hasConversation: conversationOnScreen, arrivedViaChatLink: arrivedViaChatLink }); }, [(_b = props.config) === null || _b === void 0 ? void 0 : _b.cta, conversationOnScreen, arrivedViaChatLink]);
+    // Only an embedded widget may drop its header. In normal mode the header holds the
+    // minimize and close buttons, so hiding it would leave a floating window with no way out.
+    var headerHidden = ((_c = props.config.header) === null || _c === void 0 ? void 0 : _c.hidden) === true && (dockedMode || staticMode);
+    // The header is the only place a HEADER_LEFT / HEADER_RIGHT menu button renders. Without it
+    // the menu would be unreachable, so hand the button to the footer instead.
+    var menuConfig = useMemo(function () {
+        return headerHidden && props.config.menu && props.config.menu.menuButtonLocation !== "FOOTER"
+            ? __assign$1(__assign$1({}, props.config.menu), { menuButtonLocation: "FOOTER" }) : props.config.menu;
+    }, [headerHidden, props.config.menu]);
+    var canRefresh = (_e = (_d = props.config.header) === null || _d === void 0 ? void 0 : _d.actions) === null || _e === void 0 ? void 0 : _e.refresh;
     // can't minimize in docked mode, static mode, or preview mode.
-    var canMinimize = !dockedMode && !staticMode && !previewMode && ((_e = (_d = props.config.header) === null || _d === void 0 ? void 0 : _d.actions) === null || _e === void 0 ? void 0 : _e.minimize);
-    log("docked: ".concat(dockedMode, " static: ").concat(staticMode, " preview: ").concat(previewMode, " minimized: ").concat((_g = (_f = props.config.header) === null || _f === void 0 ? void 0 : _f.actions) === null || _g === void 0 ? void 0 : _g.minimize));
+    var canMinimize = !dockedMode && !staticMode && !previewMode && ((_g = (_f = props.config.header) === null || _f === void 0 ? void 0 : _f.actions) === null || _g === void 0 ? void 0 : _g.minimize);
+    log("docked: ".concat(dockedMode, " static: ").concat(staticMode, " preview: ").concat(previewMode, " minimized: ").concat((_j = (_h = props.config.header) === null || _h === void 0 ? void 0 : _h.actions) === null || _j === void 0 ? void 0 : _j.minimize));
     var canCancel;
     // To preserve legacy behavior, cancel needs a little more checks
-    if (typeof ((_j = (_h = props.config.header) === null || _h === void 0 ? void 0 : _h.actions) === null || _j === void 0 ? void 0 : _j.cancel) === "boolean") {
-        canCancel = !dockedMode && !staticMode && !previewMode && ((_l = (_k = props.config.header) === null || _k === void 0 ? void 0 : _k.actions) === null || _l === void 0 ? void 0 : _l.cancel);
+    if (typeof ((_l = (_k = props.config.header) === null || _k === void 0 ? void 0 : _k.actions) === null || _l === void 0 ? void 0 : _l.cancel) === "boolean") {
+        canCancel = !dockedMode && !staticMode && !previewMode && ((_o = (_m = props.config.header) === null || _m === void 0 ? void 0 : _m.actions) === null || _o === void 0 ? void 0 : _o.cancel);
     }
     else {
         canCancel = !dockedMode && !staticMode && !previewMode;
@@ -37115,16 +37322,16 @@ var ChatWidgetUI = function (props) {
     }
     // Our state - pull from storage
     // Parse autoOpenOnWidth once for use in both initial state and useEffect
-    var autoOpenOnWidthValue = ((_m = props.config) === null || _m === void 0 ? void 0 : _m.autoOpenOnWidth)
+    var autoOpenOnWidthValue = ((_p = props.config) === null || _p === void 0 ? void 0 : _p.autoOpenOnWidth)
         ? parseInt(props.config.autoOpenOnWidth, 10)
         : NaN;
     var autoOpenOnWidthMatch = !isNaN(autoOpenOnWidthValue) && window.innerWidth >= autoOpenOnWidthValue;
     // When autoOpenOnWidth is configured, use width check instead of persisted visible state
     // to prevent greeting requests on viewports below the threshold
-    var _14 = useState((!canMinimize && !canCancel) ||
+    var _15 = useState((!canMinimize && !canCancel) ||
         // !!get("visible") ||
-        (!isNaN(autoOpenOnWidthValue) ? autoOpenOnWidthMatch : chatState.visuals.visible)), visible = _14[0], setVisibleState = _14[1];
-    var _15 = useState(false); _15[0]; var setTypingState = _15[1]; // false initially - state kept for potential external observers
+        (!isNaN(autoOpenOnWidthValue) ? autoOpenOnWidthMatch : chatState.visuals.visible)), visible = _15[0], setVisibleState = _15[1];
+    var _16 = useState(false); _16[0]; var setTypingState = _16[1]; // false initially - state kept for potential external observers
     // Ref to track typing state for use in timeout callbacks
     var typingRef = useRef(false);
     // Timeout ref for debouncing "stop typing" events
@@ -37132,11 +37339,11 @@ var ChatWidgetUI = function (props) {
     // Track whether autoOpenOnWidth has already fired so it doesn't re-open after user closes
     var autoOpenFiredRef = useRef(autoOpenOnWidthMatch);
     var chatServer = useContext(ChatServerContext);
-    var patternsConfig = (_p = (_o = props.config) === null || _o === void 0 ? void 0 : _o.autoOpenOnPattern) === null || _p === void 0 ? void 0 : _p.patterns;
+    var patternsConfig = (_r = (_q = props.config) === null || _q === void 0 ? void 0 : _q.autoOpenOnPattern) === null || _r === void 0 ? void 0 : _r.patterns;
     var currentUrl = window.location.href;
     var patternExist = patternsConfig && patternsConfig.length > 0;
     var patternMatches = patternsConfig === null || patternsConfig === void 0 ? void 0 : patternsConfig.some(function (pattern) { return currentUrl.includes(pattern); });
-    var configWidth = (_r = (_q = props.config) === null || _q === void 0 ? void 0 : _q.autoOpenOnPattern) === null || _r === void 0 ? void 0 : _r.minimumWidth;
+    var configWidth = (_t = (_s = props.config) === null || _s === void 0 ? void 0 : _s.autoOpenOnPattern) === null || _t === void 0 ? void 0 : _t.minimumWidth;
     var currentWidth = window.innerWidth;
     var setVisible = useCallback(function (newVisible) {
         if (staticMode || previewMode) {
@@ -37171,7 +37378,7 @@ var ChatWidgetUI = function (props) {
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    var _16 = useState(!document.hidden), isTabVisible = _16[0], setIsTabVisible = _16[1];
+    var _17 = useState(!document.hidden), isTabVisible = _17[0], setIsTabVisible = _17[1];
     useEffect(function () {
         var handleVisibilityChange = function () {
             setIsTabVisible(!document.hidden);
@@ -37395,8 +37602,8 @@ var ChatWidgetUI = function (props) {
         }));
     }
     // Action Bar state and handlers
-    var _17 = useState(false), formModalOpen = _17[0], setFormModalOpen = _17[1];
-    var _18 = useState(null), activeFormConfig = _18[0], setActiveFormConfig = _18[1];
+    var _18 = useState(false), formModalOpen = _18[0], setFormModalOpen = _18[1];
+    var _19 = useState(null), activeFormConfig = _19[0], setActiveFormConfig = _19[1];
     var handleFormButtonClick = useCallback(function (formButton) {
         // If form-widget is configured, use its openForm API
         // The form-widget script should already be pre-loaded
@@ -37463,7 +37670,7 @@ var ChatWidgetUI = function (props) {
     var messages = chatState && chatState.chats;
     log("Rendering - accountStatus: \"".concat(chatState.accountStatus, "\", connectionStatus: \"").concat(chatState.connection.connectionStatus, "\""));
     var config = props.config, onConnectionStatusChange = props.onConnectionStatusChange;
-    var actionBarEnabled = ((_s = config === null || config === void 0 ? void 0 : config.actionBar) === null || _s === void 0 ? void 0 : _s.enabled) === true;
+    var actionBarEnabled = ((_u = config === null || config === void 0 ? void 0 : config.actionBar) === null || _u === void 0 ? void 0 : _u.enabled) === true;
     // The host page declares this; the widget cannot work it out. On the standalone
     // contact/booking page the form already *is* the page, which makes every button that
     // only opens one redundant. XappMedia/chat-widget#1626.
@@ -37487,7 +37694,7 @@ var ChatWidgetUI = function (props) {
             onConnectionStatusChange(connectionStatus);
         }
     }, [connectionStatus, onConnectionStatusChange]);
-    useExternalScript((_t = props.config) === null || _t === void 0 ? void 0 : _t.middlewareUrl);
+    useExternalScript((_v = props.config) === null || _v === void 0 ? void 0 : _v.middlewareUrl);
     // Only reach for form.xapp.ai when something on this page can still open the form.
     //
     // Loading it is not free: the script mounts a second form-widget instance whose wrapper
@@ -37527,15 +37734,18 @@ var ChatWidgetUI = function (props) {
         };
     }, [actionBarVisible]);
     // This is a pseudo agent. It represent's the widget (shown in the header avatar for instance)
-    var widgetAgent = ((_u = chatState.agents["agent:robot"]) === null || _u === void 0 ? void 0 : _u.user) ||
+    var widgetAgent = ((_w = chatState.agents["agent:robot"]) === null || _w === void 0 ? void 0 : _w.user) ||
         (config === null || config === void 0 ? void 0 : config.agent) || {
         nick: "agent:robot",
         avatarPath: config.avatarUrl,
         display_name: "Agent",
     };
-    return (jsxs(Fragment, { children: [jsxs("div", { className: "widget-container ".concat(modeClass, " ").concat(getVisibilityClass()).concat(actionBarVisible ? " widget-container--with-action-bar" : ""), children: [jsx(WidgetStylesheet, { theme: config === null || config === void 0 ? void 0 : config.theme }), jsx(ChatHeader, { accountStatus: chatState.accountStatus, refreshOnClick: handleRestartClick, minimizeOnClick: handleMinimizeClick, cancelOnClick: handleCancelClick, agent: widgetAgent, canRefresh: canRefresh, canMinimize: canMinimize, canCancel: canCancel, config: config === null || config === void 0 ? void 0 : config.header, menuConfig: config.menu, debugMode: (_x = (_w = (_v = props.config) === null || _v === void 0 ? void 0 : _v.connection) === null || _w === void 0 ? void 0 : _w.mcp) === null || _x === void 0 ? void 0 : _x.debugMode, onSubmit: handleOnSubmit }), jsx(MessageList, { visible: visible, queuePosition: chatState.queuePosition, isChatting: chatState.isChatting, isOffline: isOffline, messages: messages, agents: chatState.agents, agent: config === null || config === void 0 ? void 0 : config.agent, lastRatingRequestTimestamp: chatState.lastRatingRequestTimestamp, hasRating: chatState.hasRating, visitorId: chatState.visitorId, hasWsButton: !!chatState.wsButton, messageMiddleware: props.messageMiddleware, textTypingStatusEnabled: (_z = (_y = props.config) === null || _y === void 0 ? void 0 : _y.typingStatus) === null || _z === void 0 ? void 0 : _z.textTypingStatusEnabled, disableAutoScroll: props.disableAutoScroll, onSend: handleSendMessage, onWrite: handleWriteMessage, onOpenUrl: handleOpenUrl, minimizeOnClick: handleMinimizeClick }), jsx("div", { className: "xa-spinner-container ".concat(visible && connectionStatus === "pending" ? "visible" : ""), children: jsx("div", { className: "xa-spinner" }) }), connectionStatus === "offline" && jsx(ServerOffline, {}), chatState.wsButton && visible && (jsx(WsButton, { button: chatState.wsButton, onPress: handleWsButtonPress })), jsx(ChatFooter, { isAdmin: config === null || config === void 0 ? void 0 : config.isAdmin, isChatting: chatState.isChatting, placeholder: (_0 = config === null || config === void 0 ? void 0 : config.input) === null || _0 === void 0 ? void 0 : _0.placeholder, sendButtonIcon: (_2 = (_1 = config === null || config === void 0 ? void 0 : config.footer) === null || _1 === void 0 ? void 0 : _1.sendButton) === null || _2 === void 0 ? void 0 : _2.icon, sendButtonIconHover: (_4 = (_3 = config === null || config === void 0 ? void 0 : config.footer) === null || _3 === void 0 ? void 0 : _3.sendButton) === null || _4 === void 0 ? void 0 : _4.iconHover, sendButtonIconDisabled: (_6 = (_5 = config === null || config === void 0 ? void 0 : config.footer) === null || _5 === void 0 ? void 0 : _5.sendButton) === null || _6 === void 0 ? void 0 : _6.iconDisabled, visible: visible, hasWsButton: !!chatState.wsButton, menuConfig: (_7 = props.config) === null || _7 === void 0 ? void 0 : _7.menu, footerConfig: (_8 = props.config) === null || _8 === void 0 ? void 0 : _8.footer, inputConfig: (_9 = props.config) === null || _9 === void 0 ? void 0 : _9.input, disabled: previewMode, onChange: handleOnChange, onSubmit: handleOnSubmit, onFileUpload: handleFileUpload }), jsx("div", { className: "restartModal", ref: modalRef, onClick: handleRestartModalCloseClick, children: jsx(ModalContent, { onClose: handleRestartModalCloseClick, onReset: handleReset }) })] }), actionBarVisible && config.actionBar ? (jsxs(Fragment, { children: [jsx(ActionBar, { config: __assign$1(__assign$1({}, config.actionBar), { 
+    return (jsxs(Fragment, { children: [jsxs("div", { className: "widget-container ".concat(modeClass, " ").concat(getVisibilityClass()).concat(actionBarVisible ? " widget-container--with-action-bar" : ""), children: [jsx(WidgetStylesheet, { theme: config === null || config === void 0 ? void 0 : config.theme }), !headerHidden && (jsx(ChatHeader, { accountStatus: chatState.accountStatus, refreshOnClick: handleRestartClick, minimizeOnClick: handleMinimizeClick, cancelOnClick: handleCancelClick, agent: widgetAgent, canRefresh: canRefresh, canMinimize: canMinimize, canCancel: canCancel, config: config === null || config === void 0 ? void 0 : config.header, menuConfig: config.menu, debugMode: (_z = (_y = (_x = props.config) === null || _x === void 0 ? void 0 : _x.connection) === null || _y === void 0 ? void 0 : _y.mcp) === null || _z === void 0 ? void 0 : _z.debugMode, onSubmit: handleOnSubmit })), jsx(MessageList, { visible: visible, queuePosition: chatState.queuePosition, isChatting: chatState.isChatting, isOffline: isOffline, messages: messages, agents: chatState.agents, agent: config === null || config === void 0 ? void 0 : config.agent, lastRatingRequestTimestamp: chatState.lastRatingRequestTimestamp, hasRating: chatState.hasRating, visitorId: chatState.visitorId, hasWsButton: !!chatState.wsButton, messageMiddleware: props.messageMiddleware, textTypingStatusEnabled: (_1 = (_0 = props.config) === null || _0 === void 0 ? void 0 : _0.typingStatus) === null || _1 === void 0 ? void 0 : _1.textTypingStatusEnabled, disableAutoScroll: props.disableAutoScroll, onSend: handleSendMessage, onWrite: handleWriteMessage, onOpenUrl: handleOpenUrl, minimizeOnClick: handleMinimizeClick }), jsx("div", { className: "xa-spinner-container ".concat(visible && connectionStatus === "pending" ? "visible" : ""), children: jsx("div", { className: "xa-spinner" }) }), connectionStatus === "offline" && jsx(ServerOffline, {}), chatState.wsButton && visible && (jsx(WsButton, { button: chatState.wsButton, onPress: handleWsButtonPress })), jsx(ChatFooter, { isAdmin: config === null || config === void 0 ? void 0 : config.isAdmin, isChatting: chatState.isChatting, placeholder: (_2 = config === null || config === void 0 ? void 0 : config.input) === null || _2 === void 0 ? void 0 : _2.placeholder, sendButtonIcon: (_4 = (_3 = config === null || config === void 0 ? void 0 : config.footer) === null || _3 === void 0 ? void 0 : _3.sendButton) === null || _4 === void 0 ? void 0 : _4.icon, sendButtonIconHover: (_6 = (_5 = config === null || config === void 0 ? void 0 : config.footer) === null || _5 === void 0 ? void 0 : _5.sendButton) === null || _6 === void 0 ? void 0 : _6.iconHover, sendButtonIconDisabled: (_8 = (_7 = config === null || config === void 0 ? void 0 : config.footer) === null || _7 === void 0 ? void 0 : _7.sendButton) === null || _8 === void 0 ? void 0 : _8.iconDisabled, visible: visible, hasWsButton: !!chatState.wsButton, menuConfig: menuConfig, footerConfig: (_9 = props.config) === null || _9 === void 0 ? void 0 : _9.footer, inputConfig: (_10 = props.config) === null || _10 === void 0 ? void 0 : _10.input, disabled: previewMode, onChange: handleOnChange, onSubmit: handleOnSubmit, onFileUpload: handleFileUpload }), jsx("div", { className: "restartModal", ref: modalRef, onClick: handleRestartModalCloseClick, children: jsx(ModalContent, { onClose: handleRestartModalCloseClick, onReset: handleReset }) })] }), actionBarVisible && config.actionBar ? (jsxs(Fragment, { children: [jsx(ActionBar, { config: __assign$1(__assign$1({}, config.actionBar), { 
                             // Use actionBar.cta if set, otherwise fall back to widget-level cta
-                            cta: (_10 = config.actionBar.cta) !== null && _10 !== void 0 ? _10 : config.cta }), visible: visible, chatDisabled: config.disabled, formDisabled: isFormPage, hasUserInteracted: (_11 = chatState.visuals) === null || _11 === void 0 ? void 0 : _11.hasInteracted, onChatClick: chatButtonOnClick, onChatMinimize: handleMinimizeClick, onFormClick: handleFormButtonClick, onCtaDismiss: handleCtaDismiss }), formModalOpen && activeFormConfig && (jsx(FormModal, { config: activeFormConfig, widgetEnv: config, onClose: handleFormModalClose }))] })) : (jsx(ChatButton, { addClass: visible ? "visible" : "", onClick: chatButtonOnClick, config: config === null || config === void 0 ? void 0 : config.cta, imageUrl: (_12 = config === null || config === void 0 ? void 0 : config.chatButton) === null || _12 === void 0 ? void 0 : _12.imageUrl, visible: visible, hasInteracted: (_13 = chatState.visuals) === null || _13 === void 0 ? void 0 : _13.hasInteracted, onCtaDismiss: handleCtaDismiss })), jsx(ErrorOverlay, { enableErrorOverlay: config === null || config === void 0 ? void 0 : config.enableErrorOverlay })] }));
+                            cta: resolveCta((_11 = config.actionBar.cta) !== null && _11 !== void 0 ? _11 : config.cta, {
+                                hasConversation: conversationOnScreen,
+                                arrivedViaChatLink: arrivedViaChatLink,
+                            }) }), visible: visible, chatDisabled: config.disabled, formDisabled: isFormPage, hasUserInteracted: (_12 = chatState.visuals) === null || _12 === void 0 ? void 0 : _12.hasInteracted, onChatClick: chatButtonOnClick, onChatMinimize: handleMinimizeClick, onFormClick: handleFormButtonClick, onCtaDismiss: handleCtaDismiss }), formModalOpen && activeFormConfig && (jsx(FormModal, { config: activeFormConfig, widgetEnv: config, onClose: handleFormModalClose }))] })) : (jsx(ChatButton, { addClass: visible ? "visible" : "", onClick: chatButtonOnClick, config: chatButtonCta, imageUrl: (_13 = config === null || config === void 0 ? void 0 : config.chatButton) === null || _13 === void 0 ? void 0 : _13.imageUrl, visible: visible, hasInteracted: (_14 = chatState.visuals) === null || _14 === void 0 ? void 0 : _14.hasInteracted, onCtaDismiss: handleCtaDismiss })), jsx(ErrorOverlay, { enableErrorOverlay: config === null || config === void 0 ? void 0 : config.enableErrorOverlay })] }));
 };
 /**
  * Top-level wrapper that dispatches between preview mode and connected mode.