@xbrain-swe/nova-chat-widget 0.1.10 → 0.2.4-dev.15

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   XbNovaTrack: () => XbNovaTrack,
   trackXbNovaEvent: () => trackXbNovaEvent,
   useXbNovaChat: () => useXbNovaChat,
+  useXbNovaContext: () => useXbNovaContext,
   useXbNovaFact: () => useXbNovaFact,
   useXbNovaFacts: () => useXbNovaFacts,
   useXbNovaSettings: () => useXbNovaSettings,
@@ -71,6 +72,7 @@ function useXbNovaInternal() {
   return ctx;
 }
 var VISITOR_STORAGE_KEY = "xbnova_visitor_id";
+var WIDGET_VIEW_WAIT_MS = 1e4;
 function resolveVisitorId() {
   if (typeof window === "undefined") return "";
   try {
@@ -86,6 +88,17 @@ function resolveVisitorId() {
 function resolveFactValue(value) {
   return typeof value === "function" ? value() : value;
 }
+function collectContextEntries(registry) {
+  const out = [];
+  for (const source of registry.values()) {
+    const entries = typeof source === "function" ? source() : source;
+    if (!Array.isArray(entries)) continue;
+    for (const e of entries) {
+      if (e && typeof e.title === "string" && typeof e.description === "string") out.push(e);
+    }
+  }
+  return out;
+}
 function InternalProvider({
   auth,
   clientActionHandlers,
@@ -94,21 +107,54 @@ function InternalProvider({
 }) {
   const trackRegistry = (0, import_react.useRef)(/* @__PURE__ */ new Map()).current;
   const factsRegistry = (0, import_react.useRef)(/* @__PURE__ */ new Map()).current;
+  const contextRegistry = (0, import_react.useRef)(/* @__PURE__ */ new Map()).current;
   const emptyHandlers = (0, import_react.useRef)(/* @__PURE__ */ new Map()).current;
   const visitorIdRef = (0, import_react.useRef)(null);
   if (visitorIdRef.current === null) {
     visitorIdRef.current = resolveVisitorId();
   }
+  const visitorId = auth.userKey || visitorIdRef.current;
+  const sessionId = auth.sessionKey || null;
+  const latestRef = (0, import_react.useRef)({ auth, visitorId, sessionId });
+  latestRef.current = { auth, visitorId, sessionId };
+  const sendEvent = (0, import_react.useCallback)((kind, fields = {}) => {
+    const { auth: a, visitorId: v, sessionId: sid } = latestRef.current;
+    fetch(`${a.apiBaseUrl}/v1/nudge-events`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ app_id: a.appId, kind, visitor_id: v || null, session_id: sid, ...fields })
+    }).catch(() => {
+    });
+  }, []);
+  const widgetViewSentRef = (0, import_react.useRef)(false);
+  (0, import_react.useEffect)(() => {
+    if (widgetViewSentRef.current) return;
+    const send = () => {
+      if (widgetViewSentRef.current) return;
+      widgetViewSentRef.current = true;
+      const screen = latestRef.current.auth.screen;
+      sendEvent("widget_view", screen ? { payload: { screen } } : {});
+    };
+    if (sessionId) {
+      send();
+      return;
+    }
+    const timer = setTimeout(send, WIDGET_VIEW_WAIT_MS);
+    return () => clearTimeout(timer);
+  }, [sessionId, sendEvent]);
   const value = (0, import_react.useMemo)(
     () => ({
       auth,
       trackRegistry,
       factsRegistry,
+      contextRegistry,
       clientActionHandlers: clientActionHandlers ?? emptyHandlers,
-      visitorId: visitorIdRef.current,
+      visitorId,
+      sessionId,
+      sendEvent,
       theme
     }),
-    [auth, trackRegistry, factsRegistry, clientActionHandlers, emptyHandlers, theme]
+    [auth, trackRegistry, factsRegistry, contextRegistry, clientActionHandlers, emptyHandlers, visitorId, sessionId, sendEvent, theme]
   );
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(InternalContext.Provider, { value, children });
 }
@@ -411,7 +457,7 @@ function getFocusedTrackEntry(trackRegistry) {
 }
 
 // src/nudge-loop.tsx
-var EVAL_INTERVAL_MS = 1e3;
+var EVAL_INTERVAL_MS = 250;
 var XBNOVA_EVENT_NAME = "xbnova:event";
 var SESSION_COUNT_KEY_PREFIX = "xbnova_hint_session_count:";
 var SCROLL_SETTLE_MS = 500;
@@ -604,7 +650,7 @@ function clearDebugOverlay(refs) {
   refs.bandLinesRef.current.clear();
 }
 function XbNovaNudgeLoop({ appId }) {
-  const { auth, trackRegistry, factsRegistry, visitorId } = useXbNovaInternal();
+  const { auth, trackRegistry, factsRegistry, sendEvent } = useXbNovaInternal();
   const { apiKey, apiBaseUrl, screen } = auth;
   const { hint, offerHint, autoHideHint, hintsEnabled } = useNudgeState();
   const graphRef = (0, import_react5.useRef)(null);
@@ -637,8 +683,10 @@ function XbNovaNudgeLoop({ appId }) {
       const debugEnabled = isDebugEnabled();
       const debugRefs = { panelRef: debugPanelRef, boxesRef: debugBoxesRef, bandLinesRef: debugBandLinesRef };
       if (!debugEnabled && debugPanelRef.current) clearDebugOverlay(debugRefs);
+      const tickDebug = debugEnabled ? (msg) => console.debug(msg) : () => {
+      };
       if (!graph) {
-        console.debug("[XbNova] nudge \uD3C9\uAC00 \uAC74\uB108\uB700: \uADF8\uB798\uD504\uB97C \uC544\uC9C1 \uBABB \uBD88\uB7EC\uC634");
+        tickDebug("[XbNova] nudge \uD3C9\uAC00 \uAC74\uB108\uB700: \uADF8\uB798\uD504\uB97C \uC544\uC9C1 \uBABB \uBD88\uB7EC\uC634");
         return;
       }
       const canOffer = !hintRef.current && hintsEnabledRef.current;
@@ -689,18 +737,7 @@ function XbNovaNudgeLoop({ appId }) {
           autoHideMs: messageNode.auto_hide_ms ?? 2e4,
           quickReplies: messageNode.quick_replies ?? []
         });
-        fetch(`${apiBaseUrl}/v1/nudge-events`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({
-            app_id: appId,
-            nudge_node_id: messageNode.id,
-            kind: "nudge_impression",
-            bot_id: botId,
-            visitor_id: visitorId
-          })
-        }).catch(() => {
-        });
+        sendEvent("nudge_impression", { nudge_node_id: messageNode.id, bot_id: botId });
       };
       const tryFireFrom = (node) => {
         const nextEdge = (edgesFrom.get(node.id) ?? [])[0];
@@ -728,7 +765,7 @@ function XbNovaNudgeLoop({ appId }) {
         const maxPerSession = node.max_per_session === 0 ? Infinity : node.max_per_session ?? 3;
         const sessionCount = peekSessionCount(node.id);
         if (sessionCount >= maxPerSession) {
-          console.debug(`[XbNova] \uD2B8\uB9AC\uAC70 ${node.id}(${node.trigger_type}) \uAC74\uB108\uB700: \uC138\uC158\uB2F9 \uC0C1\uD55C(${maxPerSession}) \uB3C4\uB2EC`);
+          tickDebug(`[XbNova] \uD2B8\uB9AC\uAC70 ${node.id}(${node.trigger_type}) \uAC74\uB108\uB700: \uC138\uC158\uB2F9 \uC0C1\uD55C(${maxPerSession}) \uB3C4\uB2EC`);
           if (debugEnabled && node.trigger_type === "dwell") {
             debugLines.push(`- [${node.id}] \uC138\uC158\uB2F9 \uC0C1\uD55C(${maxPerSession}) \uB3C4\uB2EC \u2014 \uB354 \uC548 \uC7BC`);
           }
@@ -763,7 +800,7 @@ function XbNovaNudgeLoop({ appId }) {
             overlapPx = status.overlapPx;
             statusDetail = `rect=[top=${status.rectTop.toFixed(0)}, bottom=${status.rectBottom.toFixed(0)}] band=[top=${status.bandTop.toFixed(0)}, bottom=${status.bandBottom.toFixed(0)}] overlapPx=${overlapPx.toFixed(0)} inBand=${inBand}`;
           }
-          console.debug(
+          tickDebug(
             `[XbNova] band dwell \uD2B8\uB9AC\uAC70=${node.id} region="${region}" band%=${fromPercent}~${toPercent} | ${statusDetail}`
           );
           dwellRecords.push({ node, state, requiredMs, region, found, screenMatches, inBand, overlapPx });
@@ -772,7 +809,7 @@ function XbNovaNudgeLoop({ appId }) {
         const fires = triggerFires(node, { screen, firedEventName });
         if (!fires) continue;
         if (!canOffer) {
-          console.debug(`[XbNova] \uD2B8\uB9AC\uAC70 ${node.id} \uC870\uAC74\uC740 \uCDA9\uC871\uD588\uC9C0\uB9CC \uC0C8 \uD78C\uD2B8 \uD45C\uC2DC\uB294 \uC7A0\uAE50 \uB9C9\uD798`);
+          tickDebug(`[XbNova] \uD2B8\uB9AC\uAC70 ${node.id} \uC870\uAC74\uC740 \uCDA9\uC871\uD588\uC9C0\uB9CC \uC0C8 \uD78C\uD2B8 \uD45C\uC2DC\uB294 \uC7A0\uAE50 \uB9C9\uD798`);
           continue;
         }
         if (tryFireFrom(node)) {
@@ -872,7 +909,7 @@ function XbNovaNudgeLoop({ appId }) {
         ensureDebugPanel(debugPanelRef, debugCollapsedRef).body.textContent = debugLines.join("\n");
       }
     },
-    [apiBaseUrl, appId, autoHideHint, factsRegistry, offerHint, screen, trackRegistry, visitorId]
+    [apiBaseUrl, appId, autoHideHint, factsRegistry, offerHint, screen, trackRegistry, sendEvent]
   );
   (0, import_react5.useEffect)(() => {
     const interval = window.setInterval(() => evaluate(null), EVAL_INTERVAL_MS);
@@ -903,6 +940,9 @@ function XbNovaProvider({
   apiBaseUrl = DEFAULT_API_BASE_URL,
   clientActions,
   theme,
+  userKey,
+  threadKey,
+  sessionKey,
   children
 }) {
   (0, import_react6.useEffect)(() => {
@@ -919,8 +959,17 @@ function XbNovaProvider({
     if (screen) bumpVisitCount(screen);
   }, [screen]);
   const auth = (0, import_react6.useMemo)(
-    () => ({ apiKey, botId, appId, apiBaseUrl, screen }),
-    [apiKey, botId, appId, apiBaseUrl, screen]
+    () => ({
+      apiKey,
+      botId,
+      appId,
+      apiBaseUrl,
+      screen,
+      userKey: userKey || void 0,
+      threadKey: threadKey || void 0,
+      sessionKey: sessionKey || void 0
+    }),
+    [apiKey, botId, appId, apiBaseUrl, screen, userKey, threadKey, sessionKey]
   );
   const resolvedTheme = (0, import_react6.useMemo)(
     () => ({ ...DEFAULT_THEME, ...theme }),
@@ -1026,12 +1075,41 @@ function XbNovaShadowRoot({
 var import_react8 = require("react");
 
 // src/stream.ts
+function fromStoredMessages(stored) {
+  return stored.map((m) => ({
+    id: m.role === "assistant" ? m.id : void 0,
+    role: m.role === "assistant" ? "assistant" : "user",
+    parts: m.parts.flatMap((p, i) => {
+      const type = String(p.type ?? "");
+      if (type === "text") {
+        const text = typeof p.text === "string" ? p.text : "";
+        return text ? [{ kind: "text", id: `${m.id}:${i}`, text }] : [];
+      }
+      if (type.startsWith("tool-")) {
+        const meta = p.providerMetadata;
+        return [
+          {
+            kind: "tool",
+            toolCallId: String(p.toolCallId ?? `${m.id}:${i}`),
+            toolName: type.slice("tool-".length),
+            state: p.state === "output-error" ? "error" : "output",
+            input: p.input,
+            output: p.output,
+            view: meta?.["kr.dsauto.chat"]?.view ?? null
+          }
+        ];
+      }
+      return [];
+    })
+  }));
+}
 async function consumeSse(response, handlers) {
   if (!response.ok || !response.body) {
     handlers.onError?.(`\uC694\uCCAD \uC2E4\uD328 (${response.status})`);
     return null;
   }
   const conversationId = response.headers.get("x-conversation-id");
+  if (conversationId) handlers.onConversationId?.(conversationId);
   const reader = response.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
@@ -1136,12 +1214,19 @@ async function resumeToolResult(apiBaseUrl, apiKey, body, handlers) {
 // src/use-chat.ts
 var DEFAULT_CLIENT_ACTION_TIMEOUT_MS = 15e3;
 function useXbNovaChat(options) {
-  const { auth, trackRegistry, clientActionHandlers, visitorId } = useXbNovaInternal();
+  const { auth, trackRegistry, contextRegistry, clientActionHandlers, visitorId, sessionId, sendEvent } = useXbNovaInternal();
   const botId = options?.botId ?? auth.botId;
   const nudgeNodeId = options?.nudgeNodeId;
-  const { apiKey, apiBaseUrl } = auth;
+  const { apiKey, apiBaseUrl, threadKey } = auth;
+  const userKey = visitorId;
   const [onboarding, setOnboarding] = (0, import_react8.useState)(null);
   const [messages, setMessages] = (0, import_react8.useState)([]);
+  const [resumed, setResumed] = (0, import_react8.useState)(false);
+  const [sentOpening, setSentOpening] = (0, import_react8.useState)(null);
+  const conversationIdRef = (0, import_react8.useRef)(null);
+  const pendingOpeningRef = (0, import_react8.useRef)(null);
+  const messagesRef = (0, import_react8.useRef)(messages);
+  messagesRef.current = messages;
   const [busy, setBusy] = (0, import_react8.useState)(false);
   const [error, setError] = (0, import_react8.useState)(null);
   const [clientResults, setClientResults] = (0, import_react8.useState)({});
@@ -1152,18 +1237,59 @@ function useXbNovaChat(options) {
   const nudgeNodeIdRef = (0, import_react8.useRef)(nudgeNodeId);
   nudgeNodeIdRef.current = nudgeNodeId;
   (0, import_react8.useEffect)(() => {
+    let cancelled = false;
     setOnboarding(null);
     setMessages([]);
+    setResumed(false);
+    setSentOpening(null);
     setError(null);
     setClientResults({});
     setFeedbackState({});
     dispatchedClientActionsRef.current = /* @__PURE__ */ new Set();
+    conversationIdRef.current = null;
+    pendingOpeningRef.current = null;
     fetch(`${apiBaseUrl}/v1/conversations`, {
       method: "POST",
       headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
-      body: JSON.stringify({ bot_id: botId, nudge_node_id: nudgeNodeIdRef.current ?? null })
-    }).then((r) => r.ok ? r.json() : Promise.reject(new Error(`${r.status}`))).then(setOnboarding).catch((e) => setError(`\uBD07\uC744 \uBD88\uB7EC\uC62C \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${e.message}`));
-  }, [apiBaseUrl, apiKey, botId]);
+      body: JSON.stringify({
+        bot_id: botId,
+        nudge_node_id: nudgeNodeIdRef.current ?? null,
+        visitor_id: userKey || null,
+        thread_key: threadKey ?? null,
+        session_id: sessionId,
+        defer: true
+      })
+    }).then((r) => r.ok ? r.json() : Promise.reject(new Error(`${r.status}`))).then((data) => {
+      if (cancelled) return;
+      if (conversationIdRef.current || messagesRef.current.length > 0) {
+        setOnboarding(data);
+        return;
+      }
+      conversationIdRef.current = data.conversation_id;
+      const restored = fromStoredMessages(data.messages ?? []);
+      for (const m of restored) {
+        for (const p of m.parts) if (p.kind === "tool") dispatchedClientActionsRef.current.add(p.toolCallId);
+      }
+      setMessages(restored);
+      setResumed(restored.length > 0);
+      setOnboarding(data);
+    }).catch((e) => {
+      if (!cancelled) setError(`\uBD07\uC744 \uBD88\uB7EC\uC62C \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${e.message}`);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [apiBaseUrl, apiKey, botId, userKey, threadKey]);
+  const openingMessage = options?.openingMessage;
+  (0, import_react8.useEffect)(() => {
+    if (!onboarding || !nudgeNodeId || !openingMessage) return;
+    if (messagesRef.current.length === 0) return;
+    setMessages((prev) => [
+      ...prev,
+      { role: "assistant", parts: [{ kind: "text", id: `nudge:${nudgeNodeId}:${prev.length}`, text: openingMessage }] }
+    ]);
+    pendingOpeningRef.current = openingMessage;
+  }, [onboarding, nudgeNodeId, openingMessage]);
   const appendToLastAssistant = (existingParts, newParts) => setMessages((prev) => {
     const next = [...prev];
     next[next.length - 1] = { ...next[next.length - 1], role: "assistant", parts: [...existingParts, ...newParts] };
@@ -1176,7 +1302,7 @@ function useXbNovaChat(options) {
     return next;
   });
   async function setFeedback(messageId, rating, reason) {
-    const conversationId = onboarding?.conversation_id;
+    const conversationId = conversationIdRef.current;
     if (!conversationId || !messageId) return;
     const prevRating = feedbackRef.current[messageId] ?? null;
     const apply = (r) => setFeedbackState((prev) => {
@@ -1202,6 +1328,14 @@ function useXbNovaChat(options) {
       apply(prevRating);
     }
   }
+  function postClientActionEvent(kind, action, label) {
+    const conversationId = conversationIdRef.current;
+    if (!conversationId) return;
+    sendEvent(kind, { conversation_id: conversationId, payload: label ? { action, label } : { action } });
+  }
+  function trackClientActionClick(action, label) {
+    postClientActionEvent("cta_click", action, label);
+  }
   async function runClientAction(spec, part, existingParts) {
     if (spec.dismissSheet) options?.onDismissSheet?.();
     let result;
@@ -1225,7 +1359,7 @@ function useXbNovaChat(options) {
       result = e instanceof Error ? `\uC624\uB958: ${e.message}` : "\uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.";
     }
     if (!spec.awaitResult) return;
-    const conversationId = onboarding?.conversation_id;
+    const conversationId = conversationIdRef.current;
     if (!conversationId) return;
     const structured = result && typeof result === "object" ? result : null;
     if (structured?.view) {
@@ -1269,6 +1403,7 @@ function useXbNovaChat(options) {
       if (!spec) continue;
       if (dispatchedClientActionsRef.current.has(part.toolCallId)) continue;
       dispatchedClientActionsRef.current.add(part.toolCallId);
+      if (spec.render) postClientActionEvent("cta_impression", part.toolName, null);
       void runClientAction(spec, part, last.parts);
     }
   }, [messages, clientActionHandlers, onboarding, apiBaseUrl, apiKey, botId]);
@@ -1288,7 +1423,17 @@ function useXbNovaChat(options) {
       return next;
     });
     const focused = getFocusedTrackEntry(trackRegistry);
-    const context = focused ? { region: focused.region, data: resolveFactValue(focused.data) } : void 0;
+    const notes = collectContextEntries(contextRegistry);
+    const screen = focused ? { region: focused.region, data: resolveFactValue(focused.data) } : {};
+    const context = focused || notes.length ? { ...screen, ...notes.length ? { notes } : {} } : void 0;
+    let openingMessage2;
+    if (messages.length === 0) {
+      openingMessage2 = (options?.openingMessage ?? onboarding?.greeting) || null;
+      setSentOpening(openingMessage2);
+    } else {
+      openingMessage2 = pendingOpeningRef.current;
+    }
+    pendingOpeningRef.current = null;
     try {
       await streamChat(
         apiBaseUrl,
@@ -1296,11 +1441,22 @@ function useXbNovaChat(options) {
         {
           bot_id: botId,
           message: trimmed,
-          conversation_id: onboarding?.conversation_id ?? null,
+          conversation_id: conversationIdRef.current,
           context,
-          nudge_node_id: nudgeNodeId ?? null
+          nudge_node_id: nudgeNodeId ?? null,
+          opening_message: openingMessage2,
+          visitor_id: userKey || null,
+          thread_key: threadKey ?? null,
+          session_id: sessionId
         },
-        { onPart: replaceLast, onMessageId: setLastAssistantId, onError: setError }
+        {
+          onPart: replaceLast,
+          onMessageId: setLastAssistantId,
+          onConversationId: (id) => {
+            conversationIdRef.current = id;
+          },
+          onError: setError
+        }
       );
     } catch (e) {
       setError(e instanceof Error ? e.message : String(e));
@@ -1308,7 +1464,19 @@ function useXbNovaChat(options) {
       setBusy(false);
     }
   }
-  return { onboarding, messages, busy, error, send, clientResults, feedback, setFeedback };
+  const opening = resumed ? null : sentOpening ?? options?.openingMessage ?? onboarding?.greeting ?? null;
+  return {
+    onboarding,
+    opening,
+    messages,
+    busy,
+    error,
+    send,
+    clientResults,
+    feedback,
+    setFeedback,
+    trackClientActionClick
+  };
 }
 
 // src/views.tsx
@@ -1441,6 +1609,13 @@ function hasVisiblePart(parts, clientActionHandlers, clientResults) {
 }
 var DISCLOSURE_SEEN_KEY = "xbnova_disclosure_seen";
 var SUMMARY_FACT_KEY = "xbnova_summary";
+function clickedControl(e) {
+  const target = e.target instanceof Element ? e.target : null;
+  const control = target?.closest("button, a, [role='button']");
+  if (!control || !e.currentTarget.contains(control)) return null;
+  const text = (control.textContent ?? "").replace(/\s+/g, " ").trim();
+  return { label: text || control.getAttribute("aria-label") || null };
+}
 function readDisclosureSeen() {
   if (typeof window === "undefined") return true;
   try {
@@ -1570,9 +1745,10 @@ function XbNovaChat({
   avatarSize = 28,
   onVerdictAction,
   feedback: feedbackEnabled = true,
-  onFeedback
+  onFeedback,
+  onOpen
 }) {
-  const { auth, trackRegistry, factsRegistry, visitorId, clientActionHandlers, theme } = useXbNovaInternal();
+  const { auth, trackRegistry, factsRegistry, clientActionHandlers, theme, sendEvent } = useXbNovaInternal();
   const themeVars = {
     "--xbnova-accent-1": theme.accentFrom,
     "--xbnova-accent-2": theme.accentTo
@@ -1593,10 +1769,11 @@ function XbNovaChat({
   const [input, setInput] = (0, import_react9.useState)("");
   const bottomRef = (0, import_react9.useRef)(null);
   const typedHintText = useTypewriter(hint?.text ?? "", hint?.triggerNodeId ?? "");
-  const { onboarding, messages, busy, error, send, clientResults, feedback, setFeedback } = useXbNovaChat({
+  const { onboarding, opening, messages, busy, error, send, clientResults, feedback, setFeedback, trackClientActionClick } = useXbNovaChat({
     onFeedback,
     botId: activeBotId ?? botId,
     nudgeNodeId: activeNudgeNodeId,
+    openingMessage: openingLine ?? void 0,
     onDismissSheet: () => setOpen(false)
   });
   const effectiveBotId = activeBotId ?? botId;
@@ -1614,12 +1791,19 @@ function XbNovaChat({
     try {
       window.localStorage.setItem(
         `xbnova_branding:${effectiveBotId}`,
-        JSON.stringify({ logo_url: onboarding.branding.logo_url, avatar_text: onboarding.branding.avatar_text })
+        JSON.stringify({
+          logo_url: onboarding.branding.logo_url,
+          avatar_text: onboarding.branding.avatar_text,
+          badge_text: onboarding.branding.badge_text,
+          disclaimer: onboarding.branding.disclaimer
+        })
       );
     } catch {
     }
   }, [onboarding?.branding, effectiveBotId]);
   const branding = onboarding?.branding ?? cachedBranding ?? void 0;
+  const badgeText = branding?.badge_text?.trim() ?? "";
+  const disclaimer = branding?.disclaimer?.trim() ?? "";
   const brandingReady = Boolean(onboarding) || cachedBranding !== null || Boolean(error);
   (0, import_react9.useEffect)(() => {
     bottomRef.current?.scrollIntoView({ behavior: "smooth" });
@@ -1649,18 +1833,7 @@ function XbNovaChat({
       setOpeningLine(consumed.text);
       setActiveNudgeNodeId(consumed.messageNodeId);
       setNudgeQuickReplies(consumed.quickReplies);
-      fetch(`${auth.apiBaseUrl}/v1/nudge-events`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          app_id: auth.appId,
-          nudge_node_id: consumed.messageNodeId,
-          kind: "nudge_open",
-          bot_id: consumed.botId,
-          visitor_id: visitorId
-        })
-      }).catch(() => {
-      });
+      sendEvent("nudge_open", { nudge_node_id: consumed.messageNodeId, bot_id: consumed.botId });
     } else {
       setNudgeQuickReplies([]);
       setActiveNudgeNodeId(void 0);
@@ -1674,6 +1847,11 @@ function XbNovaChat({
       markDisclosureSeen();
     }
     setOpen(true);
+    try {
+      onOpen?.({ fromNudge: Boolean(consumed), hintText: consumed?.text });
+    } catch (err) {
+      console.warn("[XbNova] onOpen \uCF5C\uBC31 \uC624\uB958", err);
+    }
   }
   if (!open) {
     if (barHidden) return null;
@@ -1769,7 +1947,6 @@ function XbNovaChat({
   const summary = resolveFactValue(factsRegistry.get(SUMMARY_FACT_KEY));
   const focusedLabel = getFocusedTrackEntry(trackRegistry)?.label;
   const contextLine = summary ?? (focusedLabel ? `${focusedLabel} \uBCF4\uB294 \uC911` : void 0);
-  const firstBubble = openingLine ?? onboarding?.greeting;
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_jsx_runtime7.Fragment, { children: [
     !isDesktop ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       XbNovaShadowRoot,
@@ -1806,7 +1983,10 @@ function XbNovaChat({
               }
             ),
             /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "min-w-0 flex-1", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "text-sm font-semibold", children: onboarding?.branding?.title ?? "AI \uB3D9\uD589" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "flex min-w-0 items-center gap-1.5", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "truncate text-sm font-semibold", children: onboarding?.branding?.title ?? "AI \uB3D9\uD589" }),
+                badgeText ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "shrink-0 rounded-full border border-neutral-300 px-1.5 py-px text-[10px] font-semibold leading-4 text-neutral-500 dark:border-neutral-600 dark:text-neutral-400", children: badgeText }) : null
+              ] }),
               contextLine ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "truncate text-[11px] text-neutral-400", children: contextLine }) : null
             ] }),
             /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
@@ -1822,7 +2002,7 @@ function XbNovaChat({
           ] }),
           /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "flex-1 space-y-3 overflow-y-auto p-4", children: [
             showDisclosure ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "rounded-lg bg-neutral-50 px-3 py-2 text-[11px] text-neutral-400 dark:bg-neutral-800", children: "\uC9C0\uAE08 \uBCF4\uACE0 \uACC4\uC2E0 \uD654\uBA74\uACFC \uB9E4\uBB3C \uC815\uBCF4\uB97C \uAE30\uC900\uC73C\uB85C \uC548\uB0B4\uD574 \uB4DC\uB824\uC694." }) : null,
-            firstBubble ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Bubble, { role: "assistant", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(AssistantMarkdown, { text: firstBubble }) }) : null,
+            opening ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Bubble, { role: "assistant", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(AssistantMarkdown, { text: opening }) }) : null,
             messages.map((message, i) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { children: message.role === "user" ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Bubble, { role: "user", children: message.parts.map((p) => p.kind === "text" ? p.text : "").join("") }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
               AnswerActionsFrame,
               {
@@ -1850,7 +2030,17 @@ function XbNovaChat({
                         );
                       }
                       const spec = clientActionHandlers.get(part.toolName);
-                      return spec?.render ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { children: spec.render(part.input) }, j) : null;
+                      return spec?.render ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                        "div",
+                        {
+                          onClickCapture: (e) => {
+                            const control = clickedControl(e);
+                            if (control) trackClientActionClick(part.toolName, control.label);
+                          },
+                          children: spec.render(part.input)
+                        },
+                        j
+                      ) : null;
                     }
                     return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ToolView, { part, viewRenderers, onVerdictAction }, j);
                   }),
@@ -1921,7 +2111,8 @@ function XbNovaChat({
                 )
               ]
             }
-          )
+          ),
+          disclaimer ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "-mt-1 px-4 pb-2.5 text-center text-[11px] leading-snug text-neutral-400 dark:text-neutral-500", children: disclaimer }) : null
         ] })
       }
     )
@@ -2200,6 +2391,18 @@ function useXbNovaFacts(values) {
     };
   }, [factsRegistry]);
 }
+function useXbNovaContext(entries) {
+  const { contextRegistry } = useXbNovaInternal();
+  const id = (0, import_react10.useId)();
+  (0, import_react10.useEffect)(() => {
+    contextRegistry.set(id, entries);
+  });
+  (0, import_react10.useEffect)(() => {
+    return () => {
+      contextRegistry.delete(id);
+    };
+  }, [id, contextRegistry]);
+}
 function useXbNovaVisitor() {
   const { visitorId } = useXbNovaInternal();
   return visitorId;
@@ -2221,6 +2424,7 @@ function XbNovaFacts({ values }) {
   XbNovaTrack,
   trackXbNovaEvent,
   useXbNovaChat,
+  useXbNovaContext,
   useXbNovaFact,
   useXbNovaFacts,
   useXbNovaSettings,