@usecrow/ui 0.1.15 → 0.1.17

package/dist/index.d.cts

@@ -182,6 +182,9 @@ interface WidgetConfigResponse {
     copilotStyles: CopilotStyleConfig;
     browserUseEnabled?: boolean;
     showThinking?: boolean;
+    persistAnonymousConversations?: boolean;
+    /** Custom welcome message shown when chat opens. Null uses SDK default. */
+    welcomeMessage?: string | null;
 }
 
 /** Identity data passed to the identify function */
@@ -212,6 +215,8 @@ interface CrowWidgetProps {
     previewMode?: boolean;
     /** Whether to show AI thinking/reasoning to users (overrides API setting if provided) */
     showThinking?: boolean;
+    /** Custom welcome message (overrides API setting if provided) */
+    welcomeMessage?: string;
     /** Callback when widget is ready */
     onReady?: () => void;
     /**
@@ -222,7 +227,7 @@ interface CrowWidgetProps {
     /** Client-side tools the agent can call */
     tools?: ToolsMap;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, onReady, onIdentify, tools, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -529,13 +534,17 @@ interface ToolCallEvent {
 interface UseChatOptions {
     productId: string;
     apiUrl?: string;
+    /** Whether to persist anonymous conversations across page refreshes (default: true) */
+    persistAnonymousConversations?: boolean;
+    /** Custom welcome message (uses SDK default if not provided) */
+    welcomeMessage?: string;
     onVerificationStatus?: (isVerified: boolean) => void;
     onConversationId?: (id: string) => void;
     onWorkflowEvent?: (event: WorkflowEvent) => void;
     onToolCall?: (toolCall: ToolCallEvent) => void;
     onRestoredConversation?: (conversationId: string) => void;
 }
-declare function useChat({ productId, apiUrl, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onRestoredConversation, }: UseChatOptions): {
+declare function useChat({ productId, apiUrl, persistAnonymousConversations: _persistAnonymousConversations, welcomeMessage, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onRestoredConversation, }: UseChatOptions): {
     messages: Message[];
     isLoading: boolean;
     activeToolCalls: ToolCall[];
@@ -636,6 +645,10 @@ interface UseWidgetStylesResult {
     browserUseEnabled: boolean;
     /** Whether to show thinking/reasoning to users */
     showThinking: boolean;
+    /** Whether to persist anonymous conversations across page refreshes (undefined while loading) */
+    persistAnonymousConversations: boolean | undefined;
+    /** Custom welcome message (undefined uses SDK default) */
+    welcomeMessage: string | undefined;
     /** Refetch styles from API */
     refetch: () => Promise<void>;
 }
@@ -660,6 +673,10 @@ interface UseCopilotStylesResult {
     error: Error | null;
     /** Agent name from product config */
     agentName: string;
+    /** Whether to persist anonymous conversations across page refreshes (undefined while loading) */
+    persistAnonymousConversations: boolean | undefined;
+    /** Custom welcome message (undefined uses SDK default) */
+    welcomeMessage: string | undefined;
     /** Refetch styles from API */
     refetch: () => Promise<void>;
 }

package/dist/index.d.ts

@@ -182,6 +182,9 @@ interface WidgetConfigResponse {
     copilotStyles: CopilotStyleConfig;
     browserUseEnabled?: boolean;
     showThinking?: boolean;
+    persistAnonymousConversations?: boolean;
+    /** Custom welcome message shown when chat opens. Null uses SDK default. */
+    welcomeMessage?: string | null;
 }
 
 /** Identity data passed to the identify function */
@@ -212,6 +215,8 @@ interface CrowWidgetProps {
     previewMode?: boolean;
     /** Whether to show AI thinking/reasoning to users (overrides API setting if provided) */
     showThinking?: boolean;
+    /** Custom welcome message (overrides API setting if provided) */
+    welcomeMessage?: string;
     /** Callback when widget is ready */
     onReady?: () => void;
     /**
@@ -222,7 +227,7 @@ interface CrowWidgetProps {
     /** Client-side tools the agent can call */
     tools?: ToolsMap;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, onReady, onIdentify, tools, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -529,13 +534,17 @@ interface ToolCallEvent {
 interface UseChatOptions {
     productId: string;
     apiUrl?: string;
+    /** Whether to persist anonymous conversations across page refreshes (default: true) */
+    persistAnonymousConversations?: boolean;
+    /** Custom welcome message (uses SDK default if not provided) */
+    welcomeMessage?: string;
     onVerificationStatus?: (isVerified: boolean) => void;
     onConversationId?: (id: string) => void;
     onWorkflowEvent?: (event: WorkflowEvent) => void;
     onToolCall?: (toolCall: ToolCallEvent) => void;
     onRestoredConversation?: (conversationId: string) => void;
 }
-declare function useChat({ productId, apiUrl, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onRestoredConversation, }: UseChatOptions): {
+declare function useChat({ productId, apiUrl, persistAnonymousConversations: _persistAnonymousConversations, welcomeMessage, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onRestoredConversation, }: UseChatOptions): {
     messages: Message[];
     isLoading: boolean;
     activeToolCalls: ToolCall[];
@@ -636,6 +645,10 @@ interface UseWidgetStylesResult {
     browserUseEnabled: boolean;
     /** Whether to show thinking/reasoning to users */
     showThinking: boolean;
+    /** Whether to persist anonymous conversations across page refreshes (undefined while loading) */
+    persistAnonymousConversations: boolean | undefined;
+    /** Custom welcome message (undefined uses SDK default) */
+    welcomeMessage: string | undefined;
     /** Refetch styles from API */
     refetch: () => Promise<void>;
 }
@@ -660,6 +673,10 @@ interface UseCopilotStylesResult {
     error: Error | null;
     /** Agent name from product config */
     agentName: string;
+    /** Whether to persist anonymous conversations across page refreshes (undefined while loading) */
+    persistAnonymousConversations: boolean | undefined;
+    /** Custom welcome message (undefined uses SDK default) */
+    welcomeMessage: string | undefined;
     /** Refetch styles from API */
     refetch: () => Promise<void>;
 }

package/dist/index.js

@@ -45,16 +45,19 @@ var getConversationStorageKey = (productId) => `crow_conv_${productId}`;
 function useChat({
   productId,
   apiUrl = "",
+  persistAnonymousConversations: _persistAnonymousConversations,
+  welcomeMessage,
   onVerificationStatus,
   onConversationId,
   onWorkflowEvent,
   onToolCall,
   onRestoredConversation
 }) {
+  const effectiveWelcomeMessage = welcomeMessage || DEFAULT_WELCOME_MESSAGE;
   const [messages, setMessages] = useState([
     {
       id: "welcome",
-      content: DEFAULT_WELCOME_MESSAGE,
+      content: effectiveWelcomeMessage,
       isBot: true,
       timestamp: /* @__PURE__ */ new Date()
     }
@@ -71,6 +74,18 @@ function useChat({
   const [selectedModel, setSelectedModel] = useState(DEFAULT_MODEL);
   const abortControllerRef = useRef(null);
   const hasRestoredRef = useRef(false);
+  useEffect(() => {
+    if (messages.length === 1 && messages[0].id === "welcome" && !conversationId) {
+      setMessages([
+        {
+          id: "welcome",
+          content: effectiveWelcomeMessage,
+          isBot: true,
+          timestamp: /* @__PURE__ */ new Date()
+        }
+      ]);
+    }
+  }, [effectiveWelcomeMessage]);
   useEffect(() => {
     if (conversationId && onRestoredConversation && !hasRestoredRef.current) {
       hasRestoredRef.current = true;
@@ -321,7 +336,7 @@ function useChat({
     setMessages([
       {
         id: "welcome",
-        content: DEFAULT_WELCOME_MESSAGE,
+        content: effectiveWelcomeMessage,
         isBot: true,
         timestamp: /* @__PURE__ */ new Date()
       }
@@ -331,7 +346,7 @@ function useChat({
       localStorage.removeItem(getConversationStorageKey(productId));
     } catch {
     }
-  }, [productId]);
+  }, [productId, effectiveWelcomeMessage]);
   const loadMessages = useCallback((historyMessages) => {
     setMessages(historyMessages);
   }, []);
@@ -1016,6 +1031,12 @@ function useWidgetStyles({
   const [showThinking, setShowThinking] = useState(
     styleCache.get(key)?.showThinking ?? true
   );
+  const [persistAnonymousConversations, setPersistAnonymousConversations] = useState(
+    styleCache.has(key) ? styleCache.get(key)?.persistAnonymousConversations ?? true : void 0
+  );
+  const [welcomeMessage, setWelcomeMessage] = useState(
+    styleCache.get(key)?.welcomeMessage ?? void 0
+  );
   const hasFetchedRef = useRef(false);
   const fetchStyles = async () => {
     if (skip) return;
@@ -1028,6 +1049,8 @@ function useWidgetStyles({
       setAgentName(config.agentName || "Assistant");
       setBrowserUseEnabled(config.browserUseEnabled || false);
       setShowThinking(config.showThinking ?? true);
+      setPersistAnonymousConversations(config.persistAnonymousConversations ?? true);
+      setWelcomeMessage(config.welcomeMessage ?? void 0);
     } catch (err) {
       console.error("[CrowWidget] Failed to fetch styles:", err);
       setError(err instanceof Error ? err : new Error(String(err)));
@@ -1043,6 +1066,8 @@ function useWidgetStyles({
       setAgentName(cached.agentName || "Assistant");
       setBrowserUseEnabled(cached.browserUseEnabled || false);
       setShowThinking(cached.showThinking ?? true);
+      setPersistAnonymousConversations(cached.persistAnonymousConversations ?? true);
+      setWelcomeMessage(cached.welcomeMessage ?? void 0);
       setIsLoading(false);
       return;
     }
@@ -1057,6 +1082,8 @@ function useWidgetStyles({
     agentName,
     browserUseEnabled,
     showThinking,
+    persistAnonymousConversations,
+    welcomeMessage,
     refetch: fetchStyles
   };
 }
@@ -1076,6 +1103,12 @@ function useCopilotStyles({
   const [agentName, setAgentName] = useState(
     styleCache.get(key)?.agentName || "Assistant"
   );
+  const [persistAnonymousConversations, setPersistAnonymousConversations] = useState(
+    styleCache.has(key) ? styleCache.get(key)?.persistAnonymousConversations ?? true : void 0
+  );
+  const [welcomeMessage, setWelcomeMessage] = useState(
+    styleCache.get(key)?.welcomeMessage ?? void 0
+  );
   const hasFetchedRef = useRef(false);
   const fetchStyles = async () => {
     if (skip) return;
@@ -1086,6 +1119,8 @@ function useCopilotStyles({
       styleCache.set(key, config);
       setDbStyles(config.copilotStyles);
       setAgentName(config.agentName || "Assistant");
+      setPersistAnonymousConversations(config.persistAnonymousConversations ?? true);
+      setWelcomeMessage(config.welcomeMessage ?? void 0);
     } catch (err) {
       console.error("[CrowCopilot] Failed to fetch styles:", err);
       setError(err instanceof Error ? err : new Error(String(err)));
@@ -1099,6 +1134,8 @@ function useCopilotStyles({
     if (cached) {
       setDbStyles(cached.copilotStyles);
       setAgentName(cached.agentName || "Assistant");
+      setPersistAnonymousConversations(cached.persistAnonymousConversations ?? true);
+      setWelcomeMessage(cached.welcomeMessage ?? void 0);
       setIsLoading(false);
       return;
     }
@@ -1111,6 +1148,8 @@ function useCopilotStyles({
     isLoading,
     error,
     agentName,
+    persistAnonymousConversations,
+    welcomeMessage,
     refetch: fetchStyles
   };
 }
@@ -2423,16 +2462,27 @@ function CrowWidget({
   styles: propStyles,
   previewMode = false,
   showThinking: showThinkingProp,
+  welcomeMessage: welcomeMessageProp,
   onReady,
   onIdentify,
   tools
 }) {
-  const { styles, isLoading: isLoadingStyles, agentName, browserUseEnabled, showThinking: showThinkingFromAPI } = useWidgetStyles({
+  const {
+    styles,
+    isLoading: isLoadingStyles,
+    agentName,
+    browserUseEnabled,
+    showThinking: showThinkingFromAPI,
+    persistAnonymousConversations,
+    welcomeMessage: welcomeMessageFromAPI
+  } = useWidgetStyles({
     productId,
     apiUrl,
     propStyles,
     skip: previewMode
   });
+  const welcomeMessage = welcomeMessageProp ?? welcomeMessageFromAPI;
+  console.log("[Crow Widget] persistAnonymousConversations from API:", persistAnonymousConversations, "isLoading:", isLoadingStyles);
   const showThinking = showThinkingProp ?? showThinkingFromAPI;
   const [autoTools, setAutoTools] = useState({});
   const cssVars = stylesToCssVars(styles);
@@ -2460,6 +2510,8 @@ function CrowWidget({
   const chat = useChat({
     productId,
     apiUrl,
+    persistAnonymousConversations,
+    welcomeMessage,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },
@@ -2704,7 +2756,7 @@ function CrowCopilot({
   className,
   onReady
 }) {
-  const { styles, isLoading: isLoadingStyles, agentName } = useCopilotStyles({
+  const { styles, isLoading: isLoadingStyles, agentName, persistAnonymousConversations, welcomeMessage } = useCopilotStyles({
     productId,
     apiUrl,
     propStyles,
@@ -2720,6 +2772,8 @@ function CrowCopilot({
   const chat = useChat({
     productId,
     apiUrl,
+    persistAnonymousConversations,
+    welcomeMessage,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },