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

package/dist/index.d.cts

@@ -1,5 +1,44 @@
 import * as react from 'react';
 
+/**
+ * AI SDK UI Message Stream v1 파서. `nova/web/lib/chat-stream.ts`에서 그대로 옮겼다 — 이미
+ * 콘솔에서 검증된 로직이라 새로 설계하지 않는다.
+ *
+ * `ai` 패키지에 의존하지 않는다 — 고객사 번들에 peer 버전 충돌을 만들지 않기 위해서다.
+ */
+type ViewKind = "product_list" | "product_detail" | "metric" | "choices" | "form" | "verdict";
+type ToolPart = {
+    kind: "tool";
+    toolCallId: string;
+    toolName: string;
+    state: "input" | "output" | "error";
+    input?: unknown;
+    output?: unknown;
+    /** 위젯은 tool 이름이 아니라 이 값으로 렌더러를 고른다. */
+    view?: ViewKind | null;
+};
+type TextPart = {
+    kind: "text";
+    id: string;
+    text: string;
+};
+type MessagePart = TextPart | ToolPart;
+type ChatMessage = {
+    role: "user" | "assistant";
+    parts: MessagePart[];
+};
+
+/** `awaitResult` 핸들러가 구조화된 결과를 돌려줄 때의 모양. `text`는 모델이 읽는 결과(서버로
+ * 전송)고, `view`+`output`은 채팅 말풍선에 직접 그릴 정규화된 데이터다 — 서버에는 가지 않는다.
+ * 렌더러는 tool 이름이 아니라 `view`로 고르므로(`views.tsx`) 고객사가 UI를 만들 필요가 없다.
+ * 예: 상품 검색 결과는 `view:"product_list"`, `output:{ items: ProductItem[], total }`.
+ * MCP 서버를 쓸 수 없는 환경에서 MCP tool 결과의 `_meta` view와 같은 효과를 내는 대체 경로다.
+ * 대화를 새로고침하면 이 그림은 사라진다(서버에는 `text`만 남는다). */
+type XbNovaClientActionResult = {
+    text: string;
+    view?: ViewKind;
+    output?: unknown;
+};
 type XbNovaClientAction = {
     /** 모델이 "언제 이 tool을 부를지" 판단하는 근거 — MCP tool description과 같은 역할. */
     description: string;
@@ -15,11 +54,15 @@ type XbNovaClientAction = {
      * interrupt/resume과 같은 패턴). false(기본)면 `handler`는 그냥 실행되고 끝 —
      * 반환값은 안 쓴다. */
     awaitResult?: boolean;
+    /** `awaitResult:true`일 때 핸들러 응답을 기다리는 최대 시간(ms, 기본 15000). 넘으면 SDK가
+     * "오류: 응답 시간이 초과되었습니다."를 tool 결과로 서버에 보내 모델이 대화를 이어가게
+     * 한다 — 이후 핸들러가 뒤늦게 resolve돼도 그 값은 무시된다. fire-and-forget에는 적용 안 된다. */
+    timeoutMs?: number;
     /** 실제로 실행할 동작 — 채팅에는 아무것도 안 그리고 이 함수만 호출된다. `payload`는 이
      * tool 호출의 input을 그대로 되돌려준다. `awaitResult:true`면 반환값(또는 resolve된
      * Promise)이 진짜 tool 결과 텍스트가 된다 — 비워두면 "핸들러가 결과를 반환하지
      * 않았습니다" 에러로 처리된다. */
-    handler: (payload: unknown) => void | string | Promise<void | string>;
+    handler: (payload: unknown) => void | string | XbNovaClientActionResult | Promise<void | string | XbNovaClientActionResult>;
     /** true면 이 tool이 실행되는 시점에 대화 시트를 닫는다(대화는 안 사라진다, 나중에
      * 다시 열면 이어짐). `highlight_region`처럼 "페이지의 특정 부분을 보여주는" 액션에
      * 필요하다 — 모바일에서는 시트가 화면 대부분(위 7rem 제외)을 덮어서, 시트를 안 닫으면
@@ -66,34 +109,6 @@ declare function XbNovaProvider({ apiKey, botId, appId, screen, apiBaseUrl, clie
     children: React.ReactNode;
 }): react.JSX.Element;
 
-/**
- * AI SDK UI Message Stream v1 파서. `nova/web/lib/chat-stream.ts`에서 그대로 옮겼다 — 이미
- * 콘솔에서 검증된 로직이라 새로 설계하지 않는다.
- *
- * `ai` 패키지에 의존하지 않는다 — 고객사 번들에 peer 버전 충돌을 만들지 않기 위해서다.
- */
-type ViewKind = "product_list" | "product_detail" | "metric" | "choices" | "form" | "verdict";
-type ToolPart = {
-    kind: "tool";
-    toolCallId: string;
-    toolName: string;
-    state: "input" | "output" | "error";
-    input?: unknown;
-    output?: unknown;
-    /** 위젯은 tool 이름이 아니라 이 값으로 렌더러를 고른다. */
-    view?: ViewKind | null;
-};
-type TextPart = {
-    kind: "text";
-    id: string;
-    text: string;
-};
-type MessagePart = TextPart | ToolPart;
-type ChatMessage = {
-    role: "user" | "assistant";
-    parts: MessagePart[];
-};
-
 type ProductItem = {
     id: string;
     title: string;
@@ -133,7 +148,7 @@ type ViewRenderer = (props: {
 }) => React.ReactNode;
 type ViewRendererMap = Partial<Record<ViewKind, ViewRenderer>>;
 
-declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, onVerdictAction, }: {
+declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, avatarSize, onVerdictAction, }: {
     /** 특정 view만 자체 컴포넌트로 덮어쓰고 싶을 때 — 지정 안 한 view는 기본 렌더러를 쓴다. */
     viewRenderers?: ViewRendererMap;
     /** Provider의 기본 봇 대신 다른 봇과 고정적으로 대화하고 싶을 때. 힌트를 눌러 열면
@@ -152,17 +167,26 @@ declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdr
     defaultOpen?: boolean;
     /** 기본(idle) 상태 바 문구. */
     idleText?: string;
+    /** 바(AI 버튼)의 동그란 아바타 지름(px), 기본 28. 바의 접힌 원은 52px이라 44~48이면 원을 거의 채운다.
+     * 채팅 헤더의 아바타는 이 값에 맞춰 24~36px로 따라 커진다. */
+    avatarSize?: number;
     /** 판단 카드의 행동 버튼을 눌렀을 때 — 실제 동작(상담신청 폼 열기, 섹션 스크롤 등)은
      * 소비자가 정한다. SDK는 버튼에 적힌 `action` 문자열을 그대로 넘겨줄 뿐 뜻을 모른다. */
     onVerdictAction?: (action: string) => 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 = {
@@ -171,6 +195,8 @@ type UseXbNovaChatResult = {
     busy: boolean;
     error: string | null;
     send: (text: string) => Promise<void>;
+    /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
+    clientResults: ClientResults;
 };
 /** `botId`를 넘기면 Provider의 기본 봇 대신 그 봇으로 새 대화를 연다 — 넛지 handoff가 쓴다.
  * `nudgeNodeId`를 넘기면 이 대화가 그 넛지에서 시작됐다고 서버에 표시한다 — 넛지 전환
@@ -226,4 +252,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 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 XbNovaOnboarding, XbNovaProvider, type XbNovaTheme, XbNovaTrack, trackXbNovaEvent, useXbNovaChat, useXbNovaFact, useXbNovaFacts, useXbNovaSettings, useXbNovaTrack, useXbNovaVisitor };

package/dist/index.d.ts

@@ -1,5 +1,44 @@
 import * as react from 'react';
 
+/**
+ * AI SDK UI Message Stream v1 파서. `nova/web/lib/chat-stream.ts`에서 그대로 옮겼다 — 이미
+ * 콘솔에서 검증된 로직이라 새로 설계하지 않는다.
+ *
+ * `ai` 패키지에 의존하지 않는다 — 고객사 번들에 peer 버전 충돌을 만들지 않기 위해서다.
+ */
+type ViewKind = "product_list" | "product_detail" | "metric" | "choices" | "form" | "verdict";
+type ToolPart = {
+    kind: "tool";
+    toolCallId: string;
+    toolName: string;
+    state: "input" | "output" | "error";
+    input?: unknown;
+    output?: unknown;
+    /** 위젯은 tool 이름이 아니라 이 값으로 렌더러를 고른다. */
+    view?: ViewKind | null;
+};
+type TextPart = {
+    kind: "text";
+    id: string;
+    text: string;
+};
+type MessagePart = TextPart | ToolPart;
+type ChatMessage = {
+    role: "user" | "assistant";
+    parts: MessagePart[];
+};
+
+/** `awaitResult` 핸들러가 구조화된 결과를 돌려줄 때의 모양. `text`는 모델이 읽는 결과(서버로
+ * 전송)고, `view`+`output`은 채팅 말풍선에 직접 그릴 정규화된 데이터다 — 서버에는 가지 않는다.
+ * 렌더러는 tool 이름이 아니라 `view`로 고르므로(`views.tsx`) 고객사가 UI를 만들 필요가 없다.
+ * 예: 상품 검색 결과는 `view:"product_list"`, `output:{ items: ProductItem[], total }`.
+ * MCP 서버를 쓸 수 없는 환경에서 MCP tool 결과의 `_meta` view와 같은 효과를 내는 대체 경로다.
+ * 대화를 새로고침하면 이 그림은 사라진다(서버에는 `text`만 남는다). */
+type XbNovaClientActionResult = {
+    text: string;
+    view?: ViewKind;
+    output?: unknown;
+};
 type XbNovaClientAction = {
     /** 모델이 "언제 이 tool을 부를지" 판단하는 근거 — MCP tool description과 같은 역할. */
     description: string;
@@ -15,11 +54,15 @@ type XbNovaClientAction = {
      * interrupt/resume과 같은 패턴). false(기본)면 `handler`는 그냥 실행되고 끝 —
      * 반환값은 안 쓴다. */
     awaitResult?: boolean;
+    /** `awaitResult:true`일 때 핸들러 응답을 기다리는 최대 시간(ms, 기본 15000). 넘으면 SDK가
+     * "오류: 응답 시간이 초과되었습니다."를 tool 결과로 서버에 보내 모델이 대화를 이어가게
+     * 한다 — 이후 핸들러가 뒤늦게 resolve돼도 그 값은 무시된다. fire-and-forget에는 적용 안 된다. */
+    timeoutMs?: number;
     /** 실제로 실행할 동작 — 채팅에는 아무것도 안 그리고 이 함수만 호출된다. `payload`는 이
      * tool 호출의 input을 그대로 되돌려준다. `awaitResult:true`면 반환값(또는 resolve된
      * Promise)이 진짜 tool 결과 텍스트가 된다 — 비워두면 "핸들러가 결과를 반환하지
      * 않았습니다" 에러로 처리된다. */
-    handler: (payload: unknown) => void | string | Promise<void | string>;
+    handler: (payload: unknown) => void | string | XbNovaClientActionResult | Promise<void | string | XbNovaClientActionResult>;
     /** true면 이 tool이 실행되는 시점에 대화 시트를 닫는다(대화는 안 사라진다, 나중에
      * 다시 열면 이어짐). `highlight_region`처럼 "페이지의 특정 부분을 보여주는" 액션에
      * 필요하다 — 모바일에서는 시트가 화면 대부분(위 7rem 제외)을 덮어서, 시트를 안 닫으면
@@ -66,34 +109,6 @@ declare function XbNovaProvider({ apiKey, botId, appId, screen, apiBaseUrl, clie
     children: React.ReactNode;
 }): react.JSX.Element;
 
-/**
- * AI SDK UI Message Stream v1 파서. `nova/web/lib/chat-stream.ts`에서 그대로 옮겼다 — 이미
- * 콘솔에서 검증된 로직이라 새로 설계하지 않는다.
- *
- * `ai` 패키지에 의존하지 않는다 — 고객사 번들에 peer 버전 충돌을 만들지 않기 위해서다.
- */
-type ViewKind = "product_list" | "product_detail" | "metric" | "choices" | "form" | "verdict";
-type ToolPart = {
-    kind: "tool";
-    toolCallId: string;
-    toolName: string;
-    state: "input" | "output" | "error";
-    input?: unknown;
-    output?: unknown;
-    /** 위젯은 tool 이름이 아니라 이 값으로 렌더러를 고른다. */
-    view?: ViewKind | null;
-};
-type TextPart = {
-    kind: "text";
-    id: string;
-    text: string;
-};
-type MessagePart = TextPart | ToolPart;
-type ChatMessage = {
-    role: "user" | "assistant";
-    parts: MessagePart[];
-};
-
 type ProductItem = {
     id: string;
     title: string;
@@ -133,7 +148,7 @@ type ViewRenderer = (props: {
 }) => React.ReactNode;
 type ViewRendererMap = Partial<Record<ViewKind, ViewRenderer>>;
 
-declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, onVerdictAction, }: {
+declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdropStyle, defaultOpen, idleText, avatarSize, onVerdictAction, }: {
     /** 특정 view만 자체 컴포넌트로 덮어쓰고 싶을 때 — 지정 안 한 view는 기본 렌더러를 쓴다. */
     viewRenderers?: ViewRendererMap;
     /** Provider의 기본 봇 대신 다른 봇과 고정적으로 대화하고 싶을 때. 힌트를 눌러 열면
@@ -152,17 +167,26 @@ declare function XbNovaChat({ viewRenderers, botId, barStyle, panelStyle, backdr
     defaultOpen?: boolean;
     /** 기본(idle) 상태 바 문구. */
     idleText?: string;
+    /** 바(AI 버튼)의 동그란 아바타 지름(px), 기본 28. 바의 접힌 원은 52px이라 44~48이면 원을 거의 채운다.
+     * 채팅 헤더의 아바타는 이 값에 맞춰 24~36px로 따라 커진다. */
+    avatarSize?: number;
     /** 판단 카드의 행동 버튼을 눌렀을 때 — 실제 동작(상담신청 폼 열기, 섹션 스크롤 등)은
      * 소비자가 정한다. SDK는 버튼에 적힌 `action` 문자열을 그대로 넘겨줄 뿐 뜻을 모른다. */
     onVerdictAction?: (action: string) => 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 = {
@@ -171,6 +195,8 @@ type UseXbNovaChatResult = {
     busy: boolean;
     error: string | null;
     send: (text: string) => Promise<void>;
+    /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
+    clientResults: ClientResults;
 };
 /** `botId`를 넘기면 Provider의 기본 봇 대신 그 봇으로 새 대화를 연다 — 넛지 handoff가 쓴다.
  * `nudgeNodeId`를 넘기면 이 대화가 그 넛지에서 시작됐다고 서버에 표시한다 — 넛지 전환
@@ -226,4 +252,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 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 XbNovaOnboarding, XbNovaProvider, type XbNovaTheme, XbNovaTrack, trackXbNovaEvent, useXbNovaChat, useXbNovaFact, useXbNovaFacts, useXbNovaSettings, useXbNovaTrack, useXbNovaVisitor };

package/dist/index.js

@@ -888,6 +888,7 @@ function XbNovaProvider({
         {
           handler: spec.handler,
           awaitResult: spec.awaitResult ?? false,
+          timeoutMs: spec.timeoutMs,
           dismissSheet: spec.dismissSheet ?? false,
           render: spec.render
         }
@@ -1083,6 +1084,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 botId = options?.botId ?? auth.botId;
@@ -1092,6 +1094,7 @@ function useXbNovaChat(options) {
   const [messages, setMessages] = useState3([]);
   const [busy, setBusy] = useState3(false);
   const [error, setError] = useState3(null);
+  const [clientResults, setClientResults] = useState3({});
   const dispatchedClientActionsRef = useRef7(/* @__PURE__ */ new Set());
   const nudgeNodeIdRef = useRef7(nudgeNodeId);
   nudgeNodeIdRef.current = nudgeNodeId;
@@ -1099,6 +1102,7 @@ function useXbNovaChat(options) {
     setOnboarding(null);
     setMessages([]);
     setError(null);
+    setClientResults({});
     dispatchedClientActionsRef.current = /* @__PURE__ */ new Set();
     fetch(`${apiBaseUrl}/v1/conversations`, {
       method: "POST",
@@ -1115,7 +1119,20 @@ function useXbNovaChat(options) {
     if (spec.dismissSheet) options?.onDismissSheet?.();
     let result;
     try {
-      result = await spec.handler(part.input);
+      if (!spec.awaitResult) {
+        await spec.handler(part.input);
+        return;
+      }
+      const timeoutMs = spec.timeoutMs ?? DEFAULT_CLIENT_ACTION_TIMEOUT_MS;
+      let timer;
+      const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve("\uC624\uB958: \uC751\uB2F5 \uC2DC\uAC04\uC774 \uCD08\uACFC\uB418\uC5C8\uC2B5\uB2C8\uB2E4."), timeoutMs);
+      });
+      try {
+        result = await Promise.race([Promise.resolve(spec.handler(part.input)), timeout]);
+      } finally {
+        clearTimeout(timer);
+      }
     } catch (e) {
       if (!spec.awaitResult) return;
       result = e instanceof Error ? `\uC624\uB958: ${e.message}` : "\uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.";
@@ -1123,7 +1140,15 @@ function useXbNovaChat(options) {
     if (!spec.awaitResult) return;
     const conversationId = onboarding?.conversation_id;
     if (!conversationId) return;
-    const resultText = typeof result === "string" && result.trim() ? result : "\uD578\uB4E4\uB7EC\uAC00 \uACB0\uACFC\uB97C \uBC18\uD658\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.";
+    const structured = result && typeof result === "object" ? result : null;
+    if (structured?.view) {
+      setClientResults((prev) => ({
+        ...prev,
+        [part.toolCallId]: { view: structured.view, output: structured.output }
+      }));
+    }
+    const rawText = structured ? structured.text : result;
+    const resultText = typeof rawText === "string" && rawText.trim() ? rawText : "\uD578\uB4E4\uB7EC\uAC00 \uACB0\uACFC\uB97C \uBC18\uD658\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.";
     setBusy(true);
     try {
       await resumeToolResult(
@@ -1192,7 +1217,7 @@ function useXbNovaChat(options) {
       setBusy(false);
     }
   }
-  return { onboarding, messages, busy, error, send };
+  return { onboarding, messages, busy, error, send, clientResults };
 }
 
 // src/views.tsx
@@ -1315,9 +1340,10 @@ function ToolView({
 
 // src/chat.tsx
 import { Fragment, jsx as jsx7, jsxs as jsxs3 } from "react/jsx-runtime";
-function hasVisiblePart(parts, clientActionHandlers) {
+function hasVisiblePart(parts, clientActionHandlers, clientResults) {
   return parts.some((part) => {
     if (part.kind === "text") return true;
+    if (clientResults[part.toolCallId]) return true;
     const spec = clientActionHandlers.get(part.toolName);
     return spec ? Boolean(spec.render) : true;
   });
@@ -1450,6 +1476,7 @@ function XbNovaChat({
   backdropStyle,
   defaultOpen = false,
   idleText = "AI\uC5D0\uAC8C \uC774 \uCC28 \uBB3C\uC5B4\uBCF4\uAE30",
+  avatarSize = 28,
   onVerdictAction
 }) {
   const { auth, trackRegistry, factsRegistry, visitorId, clientActionHandlers, theme } = useXbNovaInternal();
@@ -1457,6 +1484,7 @@ function XbNovaChat({
     "--xbnova-accent-1": theme.accentFrom,
     "--xbnova-accent-2": theme.accentTo
   };
+  const headerAvatarSize = Math.min(36, Math.max(24, Math.round(avatarSize * 0.8)));
   const avatarGradientStyle = {
     background: "linear-gradient(135deg, var(--xbnova-accent-1), var(--xbnova-accent-2))"
   };
@@ -1472,7 +1500,7 @@ function XbNovaChat({
   const [input, setInput] = useState4("");
   const bottomRef = useRef8(null);
   const typedHintText = useTypewriter(hint?.text ?? "", hint?.triggerNodeId ?? "");
-  const { onboarding, messages, busy, error, send } = useXbNovaChat({
+  const { onboarding, messages, busy, error, send, clientResults } = useXbNovaChat({
     botId: activeBotId ?? botId,
     nudgeNodeId: activeNudgeNodeId,
     onDismissSheet: () => setOpen(false)
@@ -1602,11 +1630,12 @@ function XbNovaChat({
                         className: "flex shrink-0 items-center justify-center",
                         style: { width: collapsedSize, height: collapsedSize },
                         children: /* @__PURE__ */ jsx7(
-                          "span",
+                          Avatar,
                           {
-                            className: "flex h-7 w-7 items-center justify-center rounded-full text-[11px] font-bold text-white shadow-md",
-                            style: avatarGradientStyle,
-                            children: "AI"
+                            branding: onboarding?.branding,
+                            size: avatarSize,
+                            className: "shadow-md",
+                            gradient: avatarGradientStyle
                           }
                         )
                       }
@@ -1650,11 +1679,12 @@ function XbNovaChat({
         children: /* @__PURE__ */ jsxs3("div", { className: "flex h-full w-full flex-col rounded-t-[20px] bg-white shadow-2xl sm:rounded-2xl sm:border sm:border-neutral-200 dark:bg-neutral-900 sm:dark:border-neutral-700", children: [
           /* @__PURE__ */ jsxs3("header", { className: "flex items-center gap-2 border-b border-neutral-200 px-3.5 py-2.5 dark:border-neutral-700", children: [
             /* @__PURE__ */ jsx7(
-              "span",
+              Avatar,
               {
-                className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-full text-[10px] font-bold text-white",
-                style: avatarGradientStyle,
-                children: "AI"
+                branding: onboarding?.branding,
+                size: headerAvatarSize,
+                className: "shrink-0",
+                gradient: avatarGradientStyle
               }
             ),
             /* @__PURE__ */ jsxs3("div", { className: "min-w-0 flex-1", children: [
@@ -1681,12 +1711,24 @@ function XbNovaChat({
                   return /* @__PURE__ */ jsx7(Bubble, { role: "assistant", children: /* @__PURE__ */ jsx7(AssistantMarkdown, { text: part.text }) }, j);
                 }
                 if (clientActionHandlers.has(part.toolName)) {
+                  const result = clientResults[part.toolCallId];
+                  if (result) {
+                    return /* @__PURE__ */ jsx7(
+                      ToolView,
+                      {
+                        part: { ...part, state: "output", view: result.view, output: result.output },
+                        viewRenderers,
+                        onVerdictAction
+                      },
+                      j
+                    );
+                  }
                   const spec = clientActionHandlers.get(part.toolName);
                   return spec?.render ? /* @__PURE__ */ jsx7("div", { children: spec.render(part.input) }, j) : null;
                 }
                 return /* @__PURE__ */ jsx7(ToolView, { part, viewRenderers, onVerdictAction }, j);
               }),
-              !hasVisiblePart(message.parts, clientActionHandlers) && 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
             ] }) }, 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 })
@@ -1757,6 +1799,37 @@ function XbNovaChat({
     )
   ] });
 }
+function Avatar({
+  branding,
+  size,
+  className = "",
+  gradient
+}) {
+  const box = { width: size, height: size };
+  const logoUrl = branding?.logo_url?.trim() ?? "";
+  const [failedUrl, setFailedUrl] = useState4("");
+  if (logoUrl && failedUrl !== logoUrl) {
+    return /* @__PURE__ */ jsx7(
+      "img",
+      {
+        src: logoUrl,
+        alt: "",
+        onError: () => setFailedUrl(logoUrl),
+        style: box,
+        className: `${className} flex-none rounded-full bg-white object-cover`
+      }
+    );
+  }
+  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
+    }
+  );
+}
 function Bubble({ role, children }) {
   const mine = role === "user";
   return /* @__PURE__ */ jsx7("div", { className: mine ? "flex justify-end" : "flex justify-start", children: /* @__PURE__ */ jsx7(