@flowengage/react-chatbot 8.0.19 → 8.0.20

package/dist/flowengage-react-chatbot.mjs

@@ -29148,10 +29148,31 @@ function rk() {
 			a.length > 2 && a.length < 200 && n.push(a), r++;
 		}
 		return n;
-	}, t = e((document.querySelector("main, [role='main']") || document.body).querySelectorAll("h1, h2, h3"));
-	t.length || (t = e(document.body.querySelectorAll("h1, h2, h3"))), t.length || (t = e(document.body.querySelectorAll("h4, h5")));
-	let n = [...new Set(t)], r = ((typeof document < "u" ? document.title : "") || "").replace(/\s*[-–—|·]\s*.+$/, "").trim().toLowerCase();
-	return (r ? n.filter((e) => e.toLowerCase().trim() !== r) : n).slice(0, 15);
+	}, t = document.querySelector("main, [role='main']") || document.body, n = e(t.querySelectorAll("h1, h2, h3"));
+	n.length || (n = e(document.body.querySelectorAll("h1, h2, h3"))), n.length || (n = e(document.body.querySelectorAll("h4, h5")));
+	let r = [...new Set(n)].slice(0, 15), i = Array.from(t.querySelectorAll("h1")).filter((e) => !e.closest("#flowengage-root, .flowengage-shell, .flowengage-widget-root") && !e.closest("nav, footer, header, aside, .nav, .footer, .header, .sidebar")), a = null;
+	if (i.length === 1) {
+		let e = Un(i[0]);
+		e && r[0] && r[0].toLowerCase().trim() === e.toLowerCase().trim() && (a = r[0]);
+	}
+	let o = "";
+	try {
+		let e = t.querySelector("h1, h2, h3, h4, h5");
+		if (e) {
+			let n = document.createRange();
+			n.setStart(t, 0), n.setEndBefore(e);
+			let r = n.cloneContents(), i = [];
+			r.querySelectorAll("p, li").forEach((e) => {
+				let t = e.textContent.replace(/\s+/g, " ").trim();
+				t.length > 20 && i.push(t);
+			}), o = i.join(" ").slice(0, 600);
+		}
+	} catch {}
+	return {
+		headings: r,
+		pageTitleHeading: a,
+		introText: o
+	};
 }
 function ik(e) {
 	if (!e || typeof document > "u") return "";
@@ -29204,6 +29225,21 @@ function ik(e) {
 				t.length && l.push(t.join("\n"));
 				return;
 			}
+			if (n === "form") {
+				let t = Array.from(e.querySelectorAll("input, textarea, select")).map((e) => {
+					let t = (e.getAttribute("type") || "text").toLowerCase();
+					if ([
+						"hidden",
+						"submit",
+						"button",
+						"reset"
+					].includes(t)) return null;
+					let n = e.getAttribute("placeholder") || e.getAttribute("aria-label") || e.getAttribute("name") || t;
+					return n ? String(n).trim().slice(0, 40) : null;
+				}).filter(Boolean), n = e.querySelector("button[type=\"submit\"], input[type=\"submit\"]"), r = n ? (n.textContent || n.value || "Submit").trim().slice(0, 40) : "Submit";
+				t.length && l.push(`[FORM PRESENT: ${t.length} field(s) — ${t.join(", ")}. Submit button: "${r}"]`);
+				return;
+			}
 			if (n === "p" || n === "blockquote") {
 				let t = e.textContent.replace(/\s+/g, " ").trim();
 				t.length > 2 && l.push(t);
@@ -29293,10 +29329,10 @@ function ak(e) {
 					try {
 						typeof window < "u" && window.scrollTo(0, 0);
 					} catch {}
-					let s = [], c = Date.now() + 12e3;
-					for (; Date.now() < c && (await new Promise((e) => setTimeout(e, 300)), s = rk(), !(s.length >= 1)););
-					nk(), $("fwh-navigate-mvp → page headings collected:", s);
-					let l = s.length ? s.join(" | ") : "none", u = s.length ? "Use ONLY these exact heading strings for fwh-highlight-mvp — never invent or abbreviate." : "No headings collected yet — call fwh-get-current-page-mvp immediately (no speech) to get the live headings before speaking or highlighting.", d = "";
+					let s = [], c = null, l = "", u = Date.now() + 12e3;
+					for (; Date.now() < u && (await new Promise((e) => setTimeout(e, 300)), {headings: s, pageTitleHeading: c, introText: l} = rk(), !(s.length >= 1)););
+					nk(), $("fwh-navigate-mvp → page headings collected:", s, "titleHeading:", c);
+					let d = s.length ? s.join(" | ") : "none", f = s.length ? "Use ONLY these exact heading strings for fwh-highlight-mvp — never invent or abbreviate." : "No headings collected yet — call fwh-get-current-page-mvp immediately (no speech) to get the live headings before speaking or highlighting.", p = c ? ` "${c}" is the PAGE TITLE, not a content section — do not fwh-highlight-mvp it separately; if doing a walkthrough, just fold this intro into your opening line: "${l || "(no intro text found)"}"` : l ? ` No separate page-title heading detected, but this intro text precedes the first section — mention it briefly before covering sections: "${l}"` : "", m = "";
 					try {
 						if (s.length > 0) {
 							let e = s.slice(0, 3), t = [];
@@ -29307,10 +29343,10 @@ function ak(e) {
 									r && t.push(`[Section: ${n}] ${r}`);
 								}
 							}
-							t.length > 0 && (d = ` CONTENT FOR FIRST FEW SECTIONS: ${t.join(" | ")}. Use this content to answer immediately if the visitor asks about one of these sections.`);
+							t.length > 0 && (m = ` CONTENT FOR FIRST FEW SECTIONS: ${t.join(" | ")}. Use this content to answer immediately if the visitor asks about one of these sections.`);
 						}
 					} catch {}
-					return UO() ? (Ar(), $("fwh-navigate-mvp ✖ landed on a not-found/404 page:", r), `NAVIGATION_PAGE_NOT_FOUND. The page at ${r} does not exist — it shows a "not found"/404 error, not real content. Do NOT offer a page overview, do NOT describe or highlight any sections, do NOT claim the navigation succeeded. Tell the visitor EXACTLY: "It looks like that page doesn't exist — I couldn't find it. Would you like me to take you somewhere else?" Then STOP and wait for their reply.`) : i ? (Ar(), `OK_NAVIGATE_SPA. Visitor is now on: ${r} (page: "${o}") | Section headings: ${l}. ${u}${d} Speak EXACTLY: "I have navigated you on ${o} page. Do you want to know about any specific section or want a complete overview?" Then STOP — wait for their reply.`) : (Ar(), `OK_NAVIGATE_SPA. CURRENT PAGE IS: ${r} (page: "${o}") | Section headings: ${l}. ${u}${d} Speak EXACTLY: "I have navigated you on ${o} page. Do you want to know about any specific section or want a complete overview?" Then STOP — wait for their reply.`);
+					return UO() ? (Ar(), $("fwh-navigate-mvp ✖ landed on a not-found/404 page:", r), `NAVIGATION_PAGE_NOT_FOUND. The page at ${r} does not exist — it shows a "not found"/404 error, not real content. Do NOT offer a page overview, do NOT describe or highlight any sections, do NOT claim the navigation succeeded. Tell the visitor EXACTLY: "It looks like that page doesn't exist — I couldn't find it. Would you like me to take you somewhere else?" Then STOP and wait for their reply.`) : i ? (Ar(), `OK_NAVIGATE_SPA. Visitor is now on: ${r} (page: "${o}") | Section headings: ${d}.${p} ${f}${m} Speak EXACTLY: "I have navigated you on ${o} page. Do you want to know about any specific section or want a complete overview?" Then STOP — wait for their reply.`) : (Ar(), `OK_NAVIGATE_SPA. CURRENT PAGE IS: ${r} (page: "${o}") | Section headings: ${d}.${p} ${f}${m} Speak EXACTLY: "I have navigated you on ${o} page. Do you want to know about any specific section or want a complete overview?" Then STOP — wait for their reply.`);
 				} catch {}
 				let o = "this";
 				try {
@@ -29345,7 +29381,7 @@ function ak(e) {
 			}
 			if (!a) {
 				$("fwh-highlight-mvp ✖ no element for:", i || n);
-				let e = rk(), t = e.length ? `Page headings: ${e.map((e) => `"${e}"`).join(" | ")}. Use one of these EXACT strings for section_text — no numbers, no quotes around them.` : "No headings found — skip highlight and continue speaking.";
+				let { headings: e } = rk(), t = e.length ? `Page headings: ${e.map((e) => `"${e}"`).join(" | ")}. Use one of these EXACT strings for section_text — no numbers, no quotes around them.` : "No headings found — skip highlight and continue speaking.";
 				return `HIGHLIGHT_NOT_FOUND: "${i || n}" on the current page. ${t}`;
 			}
 			return zn(a), $("fwh-highlight-mvp ✓", i || n), `OK_HIGHLIGHT: "${i || n}". WALKTHROUGH: continue immediately to the next section — do NOT pause between sections.`;
@@ -29481,14 +29517,16 @@ function ak(e) {
 		"fwh-request-email-mvp": async () => ($("fwh-request-email-mvp ▶"), typeof e.requestEmailCollection == "function" && e.requestEmailCollection(), "EMAIL_BOX_SHOWN. An email input text box is now visible to the visitor. Say EXACTLY: \"Please enter your email in the text box to continue.\" Then stop and wait silently — do NOT ask them to say it aloud, do NOT repeat, and do NOT answer any other question until you receive the EMAIL_SAVED message."),
 		"fwh-get-current-page-mvp": async () => {
 			if ($("fwh-get-current-page-mvp ▶"), typeof window > "u") return "Cannot determine current page (no browser context).";
-			let e = window.location.href, t = window.location.pathname, n = document.title || "", r = rk();
-			if ($("fwh-get-current-page-mvp ✓", {
+			let e = window.location.href, t = window.location.pathname, n = document.title || "", { headings: r, pageTitleHeading: i, introText: a } = rk();
+			$("fwh-get-current-page-mvp ✓", {
 				url: e,
 				path: t,
 				title: n
-			}), $("fwh-get-current-page-mvp → page headings collected:", r), !r.length) return `CURRENT_PAGE. URL: ${e} | Title: ${n} | No headings found on this page. Describe the page from your knowledge without calling this tool again.`;
-			let i = r.map((e) => `"${e}"`).join(" | ");
-			return `CURRENT_PAGE. URL: ${e} | Title: ${n} | Page sections (${r.length} total): ${i}. *** WALKTHROUGH RULES: (1) For fwh-highlight-mvp, pass the heading text EXACTLY as shown — no numbers, no extra punctuation, no paraphrasing. (2) TIMING IS CRITICAL: the tool fires AFTER the speech that comes before it. This means: put the SHORT TRANSITION (1-5 words) BEFORE the tool call, put the FULL DESCRIPTION AFTER the tool call. Pattern: "Transition phrase." + fwh-highlight-mvp("Heading") + "Full description (3-4 sentences)". NEVER describe a section before calling its highlight tool. (3) DO NOT call this tool again. If the visitor requested a walkthrough: START IT NOW — "Let me walk you through this." + fwh-highlight-mvp("${r[0] || "first heading"}") + "Description..." etc. Cover ALL ${r.length} sections without pausing. ***`;
+			}), $("fwh-get-current-page-mvp → page headings collected:", r, "titleHeading:", i);
+			let o = i ? ` NOTE: "${i}" is the PAGE TITLE, not a content section — do NOT fwh-highlight-mvp it or list it as a separate section in a walkthrough. Instead, open with a brief 1-2 sentence summary of this intro text before covering the real sections: "${a || "(no intro text captured)"}"` : a ? ` NOTE: no separate page-title heading was detected, but this intro text appears before the first section — open your walkthrough with a brief 1-2 sentence summary of it before covering sections: "${a}"` : "";
+			if (!r.length) return `CURRENT_PAGE. URL: ${e} | Title: ${n} |${o} No structured section headings found on this page. If there is intro text above, describe it; otherwise describe the page from your knowledge. Do not call this tool again.`;
+			let s = r.map((e) => `"${e}"`).join(" | ");
+			return `CURRENT_PAGE. URL: ${e} | Title: ${n} | Page sections (${r.length} total): ${s}.${o} *** WALKTHROUGH RULES: (1) For fwh-highlight-mvp, pass the heading text EXACTLY as shown — no numbers, no extra punctuation, no paraphrasing. (2) TIMING IS CRITICAL: the tool fires AFTER the speech that comes before it. This means: put the SHORT TRANSITION (1-5 words) BEFORE the tool call, put the FULL DESCRIPTION AFTER the tool call. Pattern: "Transition phrase." + fwh-highlight-mvp("Heading") + "Full description (3-4 sentences)". NEVER describe a section before calling its highlight tool. (3) DO NOT call this tool again. If the visitor requested a walkthrough: START IT NOW${o ? " (open with the intro note above first)" : ""} — "Let me walk you through this." + fwh-highlight-mvp("${r[0] || "first heading"}") + "Description..." etc. Cover ALL ${r.length} sections without pausing. ***`;
 		},
 		"fwh-list-forms-mvp": async () => {
 			let e = YO(), t = XO();
@@ -30102,13 +30140,13 @@ function _k({ orbColors: e, onEnterChat: t, onEndChat: n, agentId: r, siteId: i,
 				if (S) if (m) {
 					let e = p?.pageName || ne;
 					w.overrides = { agent: { firstMessage: `I have navigated you on ${e} page. Do you want to know about any specific section or want a complete overview?` } }, console.log(`[FlowEngage] 🔄 Agent-nav resume: firstMessage set for "${e}" (${g})`);
-				} else if (u) w.overrides = { agent: { firstMessage: "I'm still here. Go ahead!" } };
+				} else if (u) w.overrides = { agent: { firstMessage: `Welcome back! I see you're now on the ${ne} page. Would you like me to continue what I was explaining before, or would you like to know about this page instead?` } };
 				else {
 					let e = f || "";
 					w.overrides = { agent: { firstMessage: h || (b ? e ? `Hi, welcome to ${e}! How may I help you?` : "Hi, welcome! How may I help you?" : `Welcome to the ${ne} page!`) } }, b || console.log(`[FlowEngage] 🏠 Page-context override: "${ne}" for ${g}`);
 				}
 				else u && (w.overrides = { agent: { firstMessage: "" } });
-				let re = !1, E = m ? `NAVIGATION COMPLETE — The exact phrase "I have navigated you on [page] page. Do you want to know about any specific section or want a complete overview?" has already been spoken as your firstMessage. DO NOT repeat it. PRIOR CONVERSATION CONTEXT:\n${n?.transcript ? `Prior transcript:\n${n.transcript}\n` : "(no prior transcript)"}\nNow STOP — wait silently for the visitor's reply. Do NOT speak, do NOT call any tool until the visitor responds. When they reply: if they name a specific section → call fwh-get-current-page-mvp then answer immediately; if they say "overview" or anything non-specific → call fwh-get-current-page-mvp (zero speech) then do a full highlighted walkthrough.` : null, ie = !1, D = !m && !u ? "Your greeting has been spoken. Wait for the visitor to ask a question or tell you what they need. Do NOT auto-start a walkthrough or highlight any sections — let the visitor lead." : null, de = !1, ye = !1, ke = !!y, je = await ED.startSession({
+				let re = !1, E = m ? `NAVIGATION COMPLETE — The exact phrase "I have navigated you on [page] page. Do you want to know about any specific section or want a complete overview?" has already been spoken as your firstMessage. DO NOT repeat it. PRIOR CONVERSATION CONTEXT:\n${n?.transcript ? `Prior transcript:\n${n.transcript}\n` : "(no prior transcript)"}\nNow STOP — wait silently for the visitor's reply. Do NOT speak, do NOT call any tool until the visitor responds. When they reply: if they name a specific section → call fwh-get-current-page-mvp then answer immediately; if they say "overview" or anything non-specific → call fwh-get-current-page-mvp (zero speech) then do a full highlighted walkthrough.` : null, ie = !1, D = !m && !u ? "Your greeting has been spoken. Wait for the visitor to ask a question or tell you what they need. Do NOT auto-start a walkthrough or highlight any sections — let the visitor lead." : null, de = u && !m, ye = !1, ke = de ? `The question "Would you like me to continue what I was explaining before, or would you like to know about this page instead?" has already been spoken as your firstMessage. DO NOT repeat it. PRIOR CONVERSATION CONTEXT:\n${n?.transcript ? `Prior transcript:\n${n.transcript}\n` : "(no prior transcript, or the visitor navigated before saying much)"}\nNow STOP — wait silently for the visitor's reply. Do NOT speak, do NOT call any tool until they respond. When they reply: if they want you to CONTINUE the previous topic → resume verbally from the prior transcript above, do NOT call fwh-get-current-page-mvp or describe the new page unless they ask. If they want to know about THIS page → call fwh-get-current-page-mvp (zero speech) then proceed as a normal fresh-page walkthrough/description. If their reply is ambiguous, ask them to clarify which they'd prefer rather than guessing.` : null, je = !1, Pe = !1, Fe = !!y, Ie = await ED.startSession({
 					...w,
 					onConnect: ({ conversationId: e }) => {
 						_e.current = e, ve.current = Date.now(), console.log("[FlowEngage] 🎙️ AI chat session connected:", e);
@@ -30124,8 +30162,8 @@ function _k({ orbColors: e, onEnterChat: t, onEndChat: n, agentId: r, siteId: i,
 								xe.current = !1, Oe();
 								return;
 							}
-							if (ke && !ye) {
-								ye = !0, re = !0, ie = !0;
+							if (Fe && !Pe) {
+								Pe = !0, re = !0, ie = !0;
 								try {
 									le.current?.sendContextualUpdate?.("CRITICAL — EMAIL REQUIRED BEFORE ANYTHING ELSE. The visitor has not provided their email. Do NOT speak right now. Wait silently for the visitor to speak first. The MOMENT the visitor says ANYTHING — a question, a request, or just a greeting — your ENTIRE next response must be EXACTLY this one sentence: \"Before I answer that, could you please enter your email in the text box below?\" Do NOT answer their question. Do NOT say anything about the topic. Do NOT begin an answer and then switch — your first word must be \"Before\". After you say that sentence, stay completely silent until you receive an EMAIL_SAVED message, then thank them briefly and answer their question in full.");
 								} catch {}
@@ -30136,6 +30174,12 @@ function _k({ orbColors: e, onEnterChat: t, onEndChat: n, agentId: r, siteId: i,
 									le.current?.sendContextualUpdate?.(E);
 								} catch {}
 							}
+							if (ke && !ye) {
+								ye = !0;
+								try {
+									le.current?.sendContextualUpdate?.(ke);
+								} catch {}
+							}
 							if (D && !ie) {
 								ie = !0;
 								try {
@@ -30160,7 +30204,7 @@ function _k({ orbColors: e, onEnterChat: t, onEndChat: n, agentId: r, siteId: i,
 								try {
 									Bn();
 								} catch {}
-								ke && !de && !ae.current && (de = !0, ce.current = r, oe.current || (oe.current = !0, se.current = 0, te(!0), Me()));
+								Fe && !je && !ae.current && (je = !0, ce.current = r, oe.current || (oe.current = !0, se.current = 0, te(!0), Me()));
 							}
 							if (l.current = [...l.current, {
 								sender: n,
@@ -30211,10 +30255,10 @@ function _k({ orbColors: e, onEnterChat: t, onEndChat: n, agentId: r, siteId: i,
 					}
 				});
 				if (e) {
-					console.warn("[FlowEngage:VoiceDebug] ❌ cancelled=true after startSession resolved — killing session immediately"), je.endSession().catch(() => {});
+					console.warn("[FlowEngage:VoiceDebug] ❌ cancelled=true after startSession resolved — killing session immediately"), Ie.endSession().catch(() => {});
 					return;
 				}
-				o = je, le.current = je, x("listening");
+				o = Ie, le.current = Ie, x("listening");
 				try {
 					let e = typeof window < "u" ? window.location.href : "", r = "[]";
 					try {
@@ -30226,7 +30270,7 @@ function _k({ orbColors: e, onEnterChat: t, onEndChat: n, agentId: r, siteId: i,
 						n.length || (n = Array.from(document.body.querySelectorAll("h1, h2, h3")).filter((t) => !t.closest(e)).map((e) => e.textContent.replace(/\s+/g, " ").trim()).filter((e) => e.length > 2 && e.length < 200)), n.length && (a = [...new Set(n)].slice(0, 15).join(" | "));
 					} catch {}
 					let o = u && !m ? `RESUMING PRIOR SESSION — DO NOT GREET. The visitor is continuing the same conversation after a page reload. Do not introduce yourself or re-state your capabilities. Wait silently until the visitor speaks; if you must speak first, briefly acknowledge where you left off in one short sentence.\nPrior transcript:\n${n?.transcript || ""}\n\n` : "";
-					je.sendContextualUpdate(`${o}SESSION_CONTEXT (NOT a tool result — do NOT treat as CURRENT_PAGE): Visitor is on: ${e} | Approx headings for awareness only: ${a}. SiteId: ${i || "unknown"}. Forms: ${r}. The visitor is ALREADY on this page — do NOT offer to navigate there. WALKTHROUGH RULE: When the visitor asks for a walkthrough or overview of this page, you MUST IMMEDIATELY call fwh-get-current-page-mvp (zero speech — call it silently with NO words before it) to get the exact highlightable headings. The approximate headings above are for routing awareness ONLY — they are NOT precise enough for fwh-highlight-mvp. Do NOT skip fwh-get-current-page-mvp. Voice: call end_voice_session or say you are ending the session to stop.`);
+					Ie.sendContextualUpdate(`${o}SESSION_CONTEXT (NOT a tool result — do NOT treat as CURRENT_PAGE): Visitor is on: ${e} | Approx headings for awareness only: ${a}. SiteId: ${i || "unknown"}. Forms: ${r}. The visitor is ALREADY on this page — do NOT offer to navigate there. WALKTHROUGH RULE: When the visitor asks for a walkthrough or overview of this page, you MUST IMMEDIATELY call fwh-get-current-page-mvp (zero speech — call it silently with NO words before it) to get the exact highlightable headings. The approximate headings above are for routing awareness ONLY — they are NOT precise enough for fwh-highlight-mvp. Do NOT skip fwh-get-current-page-mvp. Voice: call end_voice_session or say you are ending the session to stop.`);
 				} catch {}
 				if (typeof window < "u") {
 					let t = window.location.pathname, n = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowengage/react-chatbot",
-  "version": "8.0.19",
+  "version": "8.0.20",
   "description": "Embeddable AI chat widget for React — powered by FlowEngage. Drop it in with a single siteId.",
   "keywords": [
     "chatbot",