@xbrain-swe/nova-chat-widget 0.1.7 → 0.1.9

package/dist/index.d.cts

@@ -24,6 +24,8 @@ type TextPart = {
 };
 type MessagePart = TextPart | ToolPart;
 type ChatMessage = {
+    /** assistant 메시지가 서버에 저장될 때의 id(`start` 청크의 `messageId`). 만족도 피드백 대상 식별용. */
+    id?: string;
     role: "user" | "assistant";
     parts: MessagePart[];
 };
@@ -109,6 +111,53 @@ declare function XbNovaProvider({ apiKey, botId, appId, screen, apiBaseUrl, clie
     children: React.ReactNode;
 }): react.JSX.Element;
 
+type ClientResults = Record<string, {
+    view: ViewKind;
+    output: unknown;
+}>;
+type XbNovaFeedbackRating = "up" | "down" | null;
+/** 답변 만족도 저장 성공 후 호스트로 전달되는 이벤트. `rating: null`은 평가 취소. */
+type XbNovaFeedbackEvent = {
+    conversationId: string;
+    messageId: string;
+    rating: XbNovaFeedbackRating;
+};
+type XbNovaOnboarding = {
+    conversation_id: string;
+    greeting: string;
+    quick_replies: string[];
+    branding: {
+        title?: string;
+        logo_url?: string;
+        avatar_text?: string;
+    };
+};
+type UseXbNovaChatResult = {
+    onboarding: XbNovaOnboarding | null;
+    messages: ChatMessage[];
+    busy: boolean;
+    error: string | null;
+    send: (text: string) => Promise<void>;
+    /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
+    clientResults: ClientResults;
+    /** messageId → 현재 평가. 평가 안 한 메시지는 키가 없다. */
+    feedback: Record<string, XbNovaFeedbackRating>;
+    /** 낙관적으로 반영하고 서버에 저장한다. 실패하면 되돌린다. */
+    setFeedback: (messageId: string, rating: XbNovaFeedbackRating) => Promise<void>;
+};
+/** `botId`를 넘기면 Provider의 기본 봇 대신 그 봇으로 새 대화를 연다 — 넛지 handoff가 쓴다.
+ * `nudgeNodeId`를 넘기면 이 대화가 그 넛지에서 시작됐다고 서버에 표시한다 — 넛지 전환
+ * 퍼널(노출→클릭→첫질문→전환)의 마지막 단계가 이 값이 채워진 대화 수를 센다.
+ * `onDismissSheet`는 `dismissSheet: true`인 client action이 실행될 때 호출된다 —
+ * `<XbNovaChat>`이 시트를 닫는 함수를 넘겨준다(모바일에서 시트가 페이지 대부분을 덮어서,
+ * 안 닫으면 그 밑에서 일어나는 일이 안 보인다). */
+declare function useXbNovaChat(options?: {
+    botId?: string;
+    nudgeNodeId?: string;
+    onDismissSheet?: () => void;
+    onFeedback?: (e: XbNovaFeedbackEvent) => void;
+}): UseXbNovaChatResult;
+
 type ProductItem = {
     id: string;
     title: string;
@@ -148,7 +197,7 @@ type ViewRenderer = (props: {
 }) => React.ReactNode;
 type ViewRendererMap = Partial<Record<ViewKind, ViewRenderer>>;
 
-declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, avatarSize, onVerdictAction, }: {
+declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, avatarSize, onVerdictAction, feedback: feedbackEnabled, onFeedback, }: {
     /** 특정 view만 자체 컴포넌트로 덮어쓰고 싶을 때 — 지정 안 한 view는 기본 렌더러를 쓴다. */
     viewRenderers?: ViewRendererMap;
     /** Provider의 기본 봇 대신 다른 봇과 고정적으로 대화하고 싶을 때. 힌트를 눌러 열면
@@ -173,43 +222,12 @@ declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdr
     /** 판단 카드의 행동 버튼을 눌렀을 때 — 실제 동작(상담신청 폼 열기, 섹션 스크롤 등)은
      * 소비자가 정한다. SDK는 버튼에 적힌 `action` 문자열을 그대로 넘겨줄 뿐 뜻을 모른다. */
     onVerdictAction?: (action: string) => void;
+    /** 완료된 답변 아래 👍/👎 "상담 만족도" 버튼을 보일지. 기본 true. */
+    feedback?: boolean;
+    /** 만족도가 서버에 저장된 뒤 호출된다(분석 이벤트 전송용). `rating: null`은 평가 취소. */
+    onFeedback?: (e: XbNovaFeedbackEvent) => void;
 }): react.JSX.Element | null;
 
-type ClientResults = Record<string, {
-    view: ViewKind;
-    output: unknown;
-}>;
-type XbNovaOnboarding = {
-    conversation_id: string;
-    greeting: string;
-    quick_replies: string[];
-    branding: {
-        title?: string;
-        logo_url?: string;
-        avatar_text?: string;
-    };
-};
-type UseXbNovaChatResult = {
-    onboarding: XbNovaOnboarding | null;
-    messages: ChatMessage[];
-    busy: boolean;
-    error: string | null;
-    send: (text: string) => Promise<void>;
-    /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
-    clientResults: ClientResults;
-};
-/** `botId`를 넘기면 Provider의 기본 봇 대신 그 봇으로 새 대화를 연다 — 넛지 handoff가 쓴다.
- * `nudgeNodeId`를 넘기면 이 대화가 그 넛지에서 시작됐다고 서버에 표시한다 — 넛지 전환
- * 퍼널(노출→클릭→첫질문→전환)의 마지막 단계가 이 값이 채워진 대화 수를 센다.
- * `onDismissSheet`는 `dismissSheet: true`인 client action이 실행될 때 호출된다 —
- * `<XbNovaChat>`이 시트를 닫는 함수를 넘겨준다(모바일에서 시트가 페이지 대부분을 덮어서,
- * 안 닫으면 그 밑에서 일어나는 일이 안 보인다). */
-declare function useXbNovaChat(options?: {
-    botId?: string;
-    nudgeNodeId?: string;
-    onDismissSheet?: () => void;
-}): UseXbNovaChatResult;
-
 /** ref형 — 감싸는 엘리먼트를 늘리기 싫을 때. `<div ref={useXbNovaTrack("price", data)}>`. */
 declare function useXbNovaTrack<T extends HTMLElement = HTMLElement>(region: string, data?: FactValue, label?: string): (node: T | null) => void;
 /** 선언형 — 감싸기만 하면 됨. `<XbNovaTrack region="price" data={{...}}>...</XbNovaTrack>`. */
@@ -252,4 +270,4 @@ declare function useXbNovaSettings(): {
     showBar: () => void;
 };
 
-export { type ChatMessage, type FactValue, type MessagePart, type ProductItem, type TextPart, type ToolPart, type UseXbNovaChatResult, type VerdictAction, type VerdictOutput, type ViewKind, type ViewRenderer, type ViewRendererMap, XbNovaChat, type XbNovaClientAction, type XbNovaClientActionResult, type XbNovaClientActions, XbNovaFact, XbNovaFacts, type XbNovaOnboarding, XbNovaProvider, type XbNovaTheme, XbNovaTrack, trackXbNovaEvent, useXbNovaChat, useXbNovaFact, useXbNovaFacts, useXbNovaSettings, useXbNovaTrack, useXbNovaVisitor };
+export { type ChatMessage, type FactValue, type MessagePart, type ProductItem, type TextPart, type ToolPart, type UseXbNovaChatResult, type VerdictAction, type VerdictOutput, type ViewKind, type ViewRenderer, type ViewRendererMap, XbNovaChat, type XbNovaClientAction, type XbNovaClientActionResult, type XbNovaClientActions, XbNovaFact, XbNovaFacts, type XbNovaFeedbackEvent, type XbNovaFeedbackRating, type XbNovaOnboarding, XbNovaProvider, type XbNovaTheme, XbNovaTrack, trackXbNovaEvent, useXbNovaChat, useXbNovaFact, useXbNovaFacts, useXbNovaSettings, useXbNovaTrack, useXbNovaVisitor };

package/dist/index.d.ts

@@ -24,6 +24,8 @@ type TextPart = {
 };
 type MessagePart = TextPart | ToolPart;
 type ChatMessage = {
+    /** assistant 메시지가 서버에 저장될 때의 id(`start` 청크의 `messageId`). 만족도 피드백 대상 식별용. */
+    id?: string;
     role: "user" | "assistant";
     parts: MessagePart[];
 };
@@ -109,6 +111,53 @@ declare function XbNovaProvider({ apiKey, botId, appId, screen, apiBaseUrl, clie
     children: React.ReactNode;
 }): react.JSX.Element;
 
+type ClientResults = Record<string, {
+    view: ViewKind;
+    output: unknown;
+}>;
+type XbNovaFeedbackRating = "up" | "down" | null;
+/** 답변 만족도 저장 성공 후 호스트로 전달되는 이벤트. `rating: null`은 평가 취소. */
+type XbNovaFeedbackEvent = {
+    conversationId: string;
+    messageId: string;
+    rating: XbNovaFeedbackRating;
+};
+type XbNovaOnboarding = {
+    conversation_id: string;
+    greeting: string;
+    quick_replies: string[];
+    branding: {
+        title?: string;
+        logo_url?: string;
+        avatar_text?: string;
+    };
+};
+type UseXbNovaChatResult = {
+    onboarding: XbNovaOnboarding | null;
+    messages: ChatMessage[];
+    busy: boolean;
+    error: string | null;
+    send: (text: string) => Promise<void>;
+    /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
+    clientResults: ClientResults;
+    /** messageId → 현재 평가. 평가 안 한 메시지는 키가 없다. */
+    feedback: Record<string, XbNovaFeedbackRating>;
+    /** 낙관적으로 반영하고 서버에 저장한다. 실패하면 되돌린다. */
+    setFeedback: (messageId: string, rating: XbNovaFeedbackRating) => Promise<void>;
+};
+/** `botId`를 넘기면 Provider의 기본 봇 대신 그 봇으로 새 대화를 연다 — 넛지 handoff가 쓴다.
+ * `nudgeNodeId`를 넘기면 이 대화가 그 넛지에서 시작됐다고 서버에 표시한다 — 넛지 전환
+ * 퍼널(노출→클릭→첫질문→전환)의 마지막 단계가 이 값이 채워진 대화 수를 센다.
+ * `onDismissSheet`는 `dismissSheet: true`인 client action이 실행될 때 호출된다 —
+ * `<XbNovaChat>`이 시트를 닫는 함수를 넘겨준다(모바일에서 시트가 페이지 대부분을 덮어서,
+ * 안 닫으면 그 밑에서 일어나는 일이 안 보인다). */
+declare function useXbNovaChat(options?: {
+    botId?: string;
+    nudgeNodeId?: string;
+    onDismissSheet?: () => void;
+    onFeedback?: (e: XbNovaFeedbackEvent) => void;
+}): UseXbNovaChatResult;
+
 type ProductItem = {
     id: string;
     title: string;
@@ -148,7 +197,7 @@ type ViewRenderer = (props: {
 }) => React.ReactNode;
 type ViewRendererMap = Partial<Record<ViewKind, ViewRenderer>>;
 
-declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, avatarSize, onVerdictAction, }: {
+declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, avatarSize, onVerdictAction, feedback: feedbackEnabled, onFeedback, }: {
     /** 특정 view만 자체 컴포넌트로 덮어쓰고 싶을 때 — 지정 안 한 view는 기본 렌더러를 쓴다. */
     viewRenderers?: ViewRendererMap;
     /** Provider의 기본 봇 대신 다른 봇과 고정적으로 대화하고 싶을 때. 힌트를 눌러 열면
@@ -173,43 +222,12 @@ declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdr
     /** 판단 카드의 행동 버튼을 눌렀을 때 — 실제 동작(상담신청 폼 열기, 섹션 스크롤 등)은
      * 소비자가 정한다. SDK는 버튼에 적힌 `action` 문자열을 그대로 넘겨줄 뿐 뜻을 모른다. */
     onVerdictAction?: (action: string) => void;
+    /** 완료된 답변 아래 👍/👎 "상담 만족도" 버튼을 보일지. 기본 true. */
+    feedback?: boolean;
+    /** 만족도가 서버에 저장된 뒤 호출된다(분석 이벤트 전송용). `rating: null`은 평가 취소. */
+    onFeedback?: (e: XbNovaFeedbackEvent) => void;
 }): react.JSX.Element | null;
 
-type ClientResults = Record<string, {
-    view: ViewKind;
-    output: unknown;
-}>;
-type XbNovaOnboarding = {
-    conversation_id: string;
-    greeting: string;
-    quick_replies: string[];
-    branding: {
-        title?: string;
-        logo_url?: string;
-        avatar_text?: string;
-    };
-};
-type UseXbNovaChatResult = {
-    onboarding: XbNovaOnboarding | null;
-    messages: ChatMessage[];
-    busy: boolean;
-    error: string | null;
-    send: (text: string) => Promise<void>;
-    /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
-    clientResults: ClientResults;
-};
-/** `botId`를 넘기면 Provider의 기본 봇 대신 그 봇으로 새 대화를 연다 — 넛지 handoff가 쓴다.
- * `nudgeNodeId`를 넘기면 이 대화가 그 넛지에서 시작됐다고 서버에 표시한다 — 넛지 전환
- * 퍼널(노출→클릭→첫질문→전환)의 마지막 단계가 이 값이 채워진 대화 수를 센다.
- * `onDismissSheet`는 `dismissSheet: true`인 client action이 실행될 때 호출된다 —
- * `<XbNovaChat>`이 시트를 닫는 함수를 넘겨준다(모바일에서 시트가 페이지 대부분을 덮어서,
- * 안 닫으면 그 밑에서 일어나는 일이 안 보인다). */
-declare function useXbNovaChat(options?: {
-    botId?: string;
-    nudgeNodeId?: string;
-    onDismissSheet?: () => void;
-}): UseXbNovaChatResult;
-
 /** ref형 — 감싸는 엘리먼트를 늘리기 싫을 때. `<div ref={useXbNovaTrack("price", data)}>`. */
 declare function useXbNovaTrack<T extends HTMLElement = HTMLElement>(region: string, data?: FactValue, label?: string): (node: T | null) => void;
 /** 선언형 — 감싸기만 하면 됨. `<XbNovaTrack region="price" data={{...}}>...</XbNovaTrack>`. */
@@ -252,4 +270,4 @@ declare function useXbNovaSettings(): {
     showBar: () => void;
 };
 
-export { type ChatMessage, type FactValue, type MessagePart, type ProductItem, type TextPart, type ToolPart, type UseXbNovaChatResult, type VerdictAction, type VerdictOutput, type ViewKind, type ViewRenderer, type ViewRendererMap, XbNovaChat, type XbNovaClientAction, type XbNovaClientActionResult, type XbNovaClientActions, XbNovaFact, XbNovaFacts, type XbNovaOnboarding, XbNovaProvider, type XbNovaTheme, XbNovaTrack, trackXbNovaEvent, useXbNovaChat, useXbNovaFact, useXbNovaFacts, useXbNovaSettings, useXbNovaTrack, useXbNovaVisitor };
+export { type ChatMessage, type FactValue, type MessagePart, type ProductItem, type TextPart, type ToolPart, type UseXbNovaChatResult, type VerdictAction, type VerdictOutput, type ViewKind, type ViewRenderer, type ViewRendererMap, XbNovaChat, type XbNovaClientAction, type XbNovaClientActionResult, type XbNovaClientActions, XbNovaFact, XbNovaFacts, type XbNovaFeedbackEvent, type XbNovaFeedbackRating, type XbNovaOnboarding, XbNovaProvider, type XbNovaTheme, XbNovaTrack, trackXbNovaEvent, useXbNovaChat, useXbNovaFact, useXbNovaFacts, useXbNovaSettings, useXbNovaTrack, useXbNovaVisitor };

package/dist/index.js

@@ -1010,6 +1010,9 @@ async function consumeSse(response, handlers) {
         continue;
       }
       switch (event.type) {
+        case "start":
+          if (typeof event.messageId === "string" && event.messageId) handlers.onMessageId?.(event.messageId);
+          break;
         case "text-start": {
           const id = String(event.id);
           textIndex.set(id, parts.length);
@@ -1086,7 +1089,7 @@ 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 } = useXbNovaInternal();
+  const { auth, trackRegistry, clientActionHandlers, visitorId } = useXbNovaInternal();
   const botId = options?.botId ?? auth.botId;
   const nudgeNodeId = options?.nudgeNodeId;
   const { apiKey, apiBaseUrl } = auth;
@@ -1095,6 +1098,9 @@ function useXbNovaChat(options) {
   const [busy, setBusy] = useState3(false);
   const [error, setError] = useState3(null);
   const [clientResults, setClientResults] = useState3({});
+  const [feedback, setFeedbackState] = useState3({});
+  const feedbackRef = useRef7(feedback);
+  feedbackRef.current = feedback;
   const dispatchedClientActionsRef = useRef7(/* @__PURE__ */ new Set());
   const nudgeNodeIdRef = useRef7(nudgeNodeId);
   nudgeNodeIdRef.current = nudgeNodeId;
@@ -1103,6 +1109,7 @@ function useXbNovaChat(options) {
     setMessages([]);
     setError(null);
     setClientResults({});
+    setFeedbackState({});
     dispatchedClientActionsRef.current = /* @__PURE__ */ new Set();
     fetch(`${apiBaseUrl}/v1/conversations`, {
       method: "POST",
@@ -1112,9 +1119,42 @@ function useXbNovaChat(options) {
   }, [apiBaseUrl, apiKey, botId]);
   const appendToLastAssistant = (existingParts, newParts) => setMessages((prev) => {
     const next = [...prev];
-    next[next.length - 1] = { role: "assistant", parts: [...existingParts, ...newParts] };
+    next[next.length - 1] = { ...next[next.length - 1], role: "assistant", parts: [...existingParts, ...newParts] };
+    return next;
+  });
+  const setLastAssistantId = (id) => setMessages((prev) => {
+    if (prev.length === 0) return prev;
+    const next = [...prev];
+    next[next.length - 1] = { ...next[next.length - 1], id };
     return next;
   });
+  async function setFeedback(messageId, rating) {
+    const conversationId = onboarding?.conversation_id;
+    if (!conversationId || !messageId) return;
+    const prevRating = feedbackRef.current[messageId] ?? null;
+    const apply = (r) => setFeedbackState((prev) => {
+      const next = { ...prev };
+      if (r === null) delete next[messageId];
+      else next[messageId] = r;
+      return next;
+    });
+    apply(rating);
+    try {
+      const res = await fetch(
+        `${apiBaseUrl}/v1/conversations/${encodeURIComponent(conversationId)}/messages/${encodeURIComponent(messageId)}/feedback`,
+        {
+          method: "PUT",
+          headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
+          body: JSON.stringify({ rating, visitor_id: visitorId })
+        }
+      );
+      if (!res.ok) throw new Error(`${res.status}`);
+      options?.onFeedback?.({ conversationId, messageId, rating });
+    } catch (e) {
+      console.warn("[xbnova] \uD53C\uB4DC\uBC31 \uC800\uC7A5 \uC2E4\uD328", e);
+      apply(prevRating);
+    }
+  }
   async function runClientAction(spec, part, existingParts) {
     if (spec.dismissSheet) options?.onDismissSheet?.();
     let result;
@@ -1160,7 +1200,11 @@ function useXbNovaChat(options) {
           tool_call_id: part.toolCallId,
           result_text: resultText
         },
-        { onPart: (newParts) => appendToLastAssistant(existingParts, newParts), onError: setError }
+        {
+          onPart: (newParts) => appendToLastAssistant(existingParts, newParts),
+          onMessageId: setLastAssistantId,
+          onError: setError
+        }
       );
     } catch (e) {
       setError(e instanceof Error ? e.message : String(e));
@@ -1193,7 +1237,7 @@ function useXbNovaChat(options) {
     ]);
     const replaceLast = (parts) => setMessages((prev) => {
       const next = [...prev];
-      next[next.length - 1] = { role: "assistant", parts };
+      next[next.length - 1] = { ...next[next.length - 1], role: "assistant", parts };
       return next;
     });
     const focused = getFocusedTrackEntry(trackRegistry);
@@ -1209,7 +1253,7 @@ function useXbNovaChat(options) {
           context,
           nudge_node_id: nudgeNodeId ?? null
         },
-        { onPart: replaceLast, onError: setError }
+        { onPart: replaceLast, onMessageId: setLastAssistantId, onError: setError }
       );
     } catch (e) {
       setError(e instanceof Error ? e.message : String(e));
@@ -1217,7 +1261,7 @@ function useXbNovaChat(options) {
       setBusy(false);
     }
   }
-  return { onboarding, messages, busy, error, send, clientResults };
+  return { onboarding, messages, busy, error, send, clientResults, feedback, setFeedback };
 }
 
 // src/views.tsx
@@ -1477,7 +1521,9 @@ function XbNovaChat({
   defaultOpen = false,
   idleText = "AI\uC5D0\uAC8C \uC774 \uCC28 \uBB3C\uC5B4\uBCF4\uAE30",
   avatarSize = 28,
-  onVerdictAction
+  onVerdictAction,
+  feedback: feedbackEnabled = true,
+  onFeedback
 }) {
   const { auth, trackRegistry, factsRegistry, visitorId, clientActionHandlers, theme } = useXbNovaInternal();
   const themeVars = {
@@ -1500,11 +1546,34 @@ function XbNovaChat({
   const [input, setInput] = useState4("");
   const bottomRef = useRef8(null);
   const typedHintText = useTypewriter(hint?.text ?? "", hint?.triggerNodeId ?? "");
-  const { onboarding, messages, busy, error, send, clientResults } = useXbNovaChat({
+  const { onboarding, messages, busy, error, send, clientResults, feedback, setFeedback } = useXbNovaChat({
+    onFeedback,
     botId: activeBotId ?? botId,
     nudgeNodeId: activeNudgeNodeId,
     onDismissSheet: () => setOpen(false)
   });
+  const effectiveBotId = activeBotId ?? botId;
+  const [cachedBranding, setCachedBranding] = useState4(null);
+  useEffect8(() => {
+    try {
+      const raw = window.localStorage.getItem(`xbnova_branding:${effectiveBotId}`);
+      setCachedBranding(raw ? JSON.parse(raw) : null);
+    } catch {
+      setCachedBranding(null);
+    }
+  }, [effectiveBotId]);
+  useEffect8(() => {
+    if (!onboarding?.branding) return;
+    try {
+      window.localStorage.setItem(
+        `xbnova_branding:${effectiveBotId}`,
+        JSON.stringify({ logo_url: onboarding.branding.logo_url, avatar_text: onboarding.branding.avatar_text })
+      );
+    } catch {
+    }
+  }, [onboarding?.branding, effectiveBotId]);
+  const branding = onboarding?.branding ?? cachedBranding ?? void 0;
+  const brandingReady = Boolean(onboarding) || cachedBranding !== null || Boolean(error);
   useEffect8(() => {
     bottomRef.current?.scrollIntoView({ behavior: "smooth" });
   }, [messages]);
@@ -1632,7 +1701,8 @@ function XbNovaChat({
                         children: /* @__PURE__ */ jsx7(
                           Avatar,
                           {
-                            branding: onboarding?.branding,
+                            branding,
+                            ready: brandingReady,
                             size: avatarSize,
                             className: "shadow-md",
                             gradient: avatarGradientStyle
@@ -1681,7 +1751,8 @@ function XbNovaChat({
             /* @__PURE__ */ jsx7(
               Avatar,
               {
-                branding: onboarding?.branding,
+                branding,
+                ready: brandingReady,
                 size: headerAvatarSize,
                 className: "shrink-0",
                 gradient: avatarGradientStyle
@@ -1728,7 +1799,14 @@ function XbNovaChat({
                 }
                 return /* @__PURE__ */ jsx7(ToolView, { part, viewRenderers, onVerdictAction }, j);
               }),
-              !hasVisiblePart(message.parts, clientActionHandlers, clientResults) && busy ? /* @__PURE__ */ jsx7(Bubble, { role: "assistant", children: /* @__PURE__ */ jsx7("span", { className: "text-neutral-400", children: "\uC0DD\uAC01\uD558\uB294 \uC911\u2026" }) }) : null
+              !hasVisiblePart(message.parts, clientActionHandlers, clientResults) && busy ? /* @__PURE__ */ jsx7(Bubble, { role: "assistant", children: /* @__PURE__ */ jsx7("span", { className: "text-neutral-400", children: "\uC0DD\uAC01\uD558\uB294 \uC911\u2026" }) }) : null,
+              feedbackEnabled && !busy && message.id && message.parts.some((p) => p.kind === "text" && p.text.trim()) ? /* @__PURE__ */ jsx7(
+                FeedbackButtons,
+                {
+                  rating: feedback[message.id] ?? null,
+                  onChange: (r) => void setFeedback(message.id, r)
+                }
+              ) : null
             ] }) }, i)),
             error ? /* @__PURE__ */ jsx7("div", { className: "rounded-lg bg-red-50 px-3 py-2 text-xs text-red-700 dark:bg-red-950 dark:text-red-300", children: error }) : null,
             /* @__PURE__ */ jsx7("div", { ref: bottomRef })
@@ -1801,6 +1879,7 @@ function XbNovaChat({
 }
 function Avatar({
   branding,
+  ready,
   size,
   className = "",
   gradient
@@ -1808,27 +1887,67 @@ function Avatar({
   const box = { width: size, height: size };
   const logoUrl = branding?.logo_url?.trim() ?? "";
   const [failedUrl, setFailedUrl] = useState4("");
+  const [loadedUrl, setLoadedUrl] = useState4("");
+  const base = `${className} relative flex flex-none items-center justify-center overflow-hidden rounded-full font-bold text-white`;
+  if (!ready) {
+    return /* @__PURE__ */ jsx7("span", { className: base, style: { ...gradient, ...box }, "aria-hidden": true });
+  }
   if (logoUrl && failedUrl !== logoUrl) {
-    return /* @__PURE__ */ jsx7(
+    return /* @__PURE__ */ jsx7("span", { className: base, style: { ...gradient, ...box }, children: /* @__PURE__ */ jsx7(
       "img",
       {
         src: logoUrl,
         alt: "",
+        onLoad: () => setLoadedUrl(logoUrl),
         onError: () => setFailedUrl(logoUrl),
-        style: box,
-        className: `${className} flex-none rounded-full bg-white object-cover`
+        className: "absolute inset-0 h-full w-full rounded-full bg-white object-cover transition-opacity duration-200",
+        style: { opacity: loadedUrl === logoUrl ? 1 : 0 }
       }
-    );
+    ) });
   }
   const text = branding?.avatar_text?.trim() || "AI";
-  return /* @__PURE__ */ jsx7(
-    "span",
-    {
-      className: `${className} flex flex-none items-center justify-center rounded-full font-bold text-white`,
-      style: { ...gradient, ...box, fontSize: Math.max(10, Math.round(size * 0.4)) },
-      children: text
-    }
-  );
+  return /* @__PURE__ */ jsx7("span", { className: base, style: { ...gradient, ...box, fontSize: Math.max(10, Math.round(size * 0.4)) }, children: text });
+}
+var THUMB_UP_PATH = "M7 10v12M15 5.88 14 10h5.83a2 2 0 0 1 1.92 2.56l-2.33 8A2 2 0 0 1 17.5 22H4a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2h2.76a2 2 0 0 0 1.79-1.11L12 2a3.13 3.13 0 0 1 3 3.88Z";
+var THUMB_DOWN_PATH = "M17 14V2M9 18.12 10 14H4.17a2 2 0 0 1-1.92-2.56l2.33-8A2 2 0 0 1 6.5 2H20a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2.76a2 2 0 0 0-1.79 1.11L12 22a3.13 3.13 0 0 1-3-3.88Z";
+function FeedbackButtons({
+  rating,
+  onChange
+}) {
+  const item = (kind, label, path) => {
+    const selected = rating === kind;
+    const color = selected ? kind === "up" ? "var(--xbnova-accent-1, #4f46e5)" : "#dc2626" : void 0;
+    return /* @__PURE__ */ jsx7(
+      "button",
+      {
+        type: "button",
+        "aria-label": label,
+        "aria-pressed": selected,
+        onClick: () => onChange(selected ? null : kind),
+        className: "flex h-6 w-6 items-center justify-center rounded-md text-neutral-400 transition-colors hover:text-neutral-600 dark:text-neutral-500 dark:hover:text-neutral-300",
+        style: color ? { color } : void 0,
+        children: /* @__PURE__ */ jsx7(
+          "svg",
+          {
+            width: "16",
+            height: "16",
+            viewBox: "0 0 24 24",
+            fill: selected ? "currentColor" : "none",
+            stroke: "currentColor",
+            strokeWidth: "2",
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            "aria-hidden": "true",
+            children: /* @__PURE__ */ jsx7("path", { d: path })
+          }
+        )
+      }
+    );
+  };
+  return /* @__PURE__ */ jsxs3("div", { className: "flex items-center gap-0.5 pl-1", children: [
+    item("up", "\uB3C4\uC6C0\uC774 \uB410\uC5B4\uC694", THUMB_UP_PATH),
+    item("down", "\uB3C4\uC6C0\uC774 \uC548 \uB410\uC5B4\uC694", THUMB_DOWN_PATH)
+  ] });
 }
 function Bubble({ role, children }) {
   const mine = role === "user";