@usecrow/ui 0.1.15 → 0.1.16

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, 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, 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

@@ -42,41 +42,68 @@ var MESSAGES_CONTAINER_ID = "crow-messages-container";
 
 // src/hooks/useChat.ts
 var getConversationStorageKey = (productId) => `crow_conv_${productId}`;
+var inMemoryConversations = {};
 function useChat({
   productId,
   apiUrl = "",
+  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()
     }
   ]);
   const [isLoading, setIsLoading] = useState(false);
   const [activeToolCalls, setActiveToolCalls] = useState([]);
-  const [conversationId, setConversationId] = useState(() => {
-    try {
-      return localStorage.getItem(getConversationStorageKey(productId));
-    } catch {
-      return null;
-    }
-  });
+  const [conversationId, setConversationId] = useState(null);
   const [selectedModel, setSelectedModel] = useState(DEFAULT_MODEL);
   const abortControllerRef = useRef(null);
-  const hasRestoredRef = useRef(false);
+  const hasInitializedConversationRef = useRef(false);
   useEffect(() => {
-    if (conversationId && onRestoredConversation && !hasRestoredRef.current) {
-      hasRestoredRef.current = true;
-      onRestoredConversation(conversationId);
+    if (messages.length === 1 && messages[0].id === "welcome" && !conversationId) {
+      setMessages([
+        {
+          id: "welcome",
+          content: effectiveWelcomeMessage,
+          isBot: true,
+          timestamp: /* @__PURE__ */ new Date()
+        }
+      ]);
     }
-  }, []);
+  }, [effectiveWelcomeMessage]);
+  useEffect(() => {
+    if (hasInitializedConversationRef.current || persistAnonymousConversations === void 0) {
+      return;
+    }
+    hasInitializedConversationRef.current = true;
+    try {
+      if (persistAnonymousConversations) {
+        const convId = localStorage.getItem(getConversationStorageKey(productId));
+        if (convId) {
+          setConversationId(convId);
+          onRestoredConversation?.(convId);
+        }
+      } else {
+        const convId = inMemoryConversations[productId];
+        if (convId) {
+          setConversationId(convId);
+          onRestoredConversation?.(convId);
+        }
+      }
+    } catch (e) {
+      console.error("[Crow] Error initializing conversation:", e);
+    }
+  }, [persistAnonymousConversations, productId, onRestoredConversation]);
   const streamFromBackend = useCallback(
     async (message, botMsgId) => {
       let accumulatedText = "";
@@ -134,12 +161,16 @@ function useChat({
                     case "conversation_id":
                       if (parsed.conversation_id) {
                         setConversationId(parsed.conversation_id);
-                        try {
-                          localStorage.setItem(
-                            getConversationStorageKey(productId),
-                            parsed.conversation_id
-                          );
-                        } catch {
+                        if (persistAnonymousConversations) {
+                          try {
+                            localStorage.setItem(
+                              getConversationStorageKey(productId),
+                              parsed.conversation_id
+                            );
+                          } catch {
+                          }
+                        } else {
+                          inMemoryConversations[productId] = parsed.conversation_id;
                         }
                         onConversationId?.(parsed.conversation_id);
                       }
@@ -277,7 +308,7 @@ function useChat({
         abortControllerRef.current = null;
       }
     },
-    [apiUrl, productId, conversationId, selectedModel, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall]
+    [apiUrl, productId, conversationId, selectedModel, persistAnonymousConversations, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall]
   );
   const sendMessage = useCallback(
     (content) => {
@@ -321,17 +352,18 @@ function useChat({
     setMessages([
       {
         id: "welcome",
-        content: DEFAULT_WELCOME_MESSAGE,
+        content: effectiveWelcomeMessage,
         isBot: true,
         timestamp: /* @__PURE__ */ new Date()
       }
     ]);
     setConversationId(null);
+    delete inMemoryConversations[productId];
     try {
       localStorage.removeItem(getConversationStorageKey(productId));
     } catch {
     }
-  }, [productId]);
+  }, [productId, effectiveWelcomeMessage]);
   const loadMessages = useCallback((historyMessages) => {
     setMessages(historyMessages);
   }, []);
@@ -1016,6 +1048,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 +1066,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 +1083,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 +1099,8 @@ function useWidgetStyles({
     agentName,
     browserUseEnabled,
     showThinking,
+    persistAnonymousConversations,
+    welcomeMessage,
     refetch: fetchStyles
   };
 }
@@ -1076,6 +1120,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 +1136,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 +1151,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 +1165,8 @@ function useCopilotStyles({
     isLoading,
     error,
     agentName,
+    persistAnonymousConversations,
+    welcomeMessage,
     refetch: fetchStyles
   };
 }
@@ -2423,16 +2479,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 +2527,8 @@ function CrowWidget({
   const chat = useChat({
     productId,
     apiUrl,
+    persistAnonymousConversations,
+    welcomeMessage,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },
@@ -2704,7 +2773,7 @@ function CrowCopilot({
   className,
   onReady
 }) {
-  const { styles, isLoading: isLoadingStyles, agentName } = useCopilotStyles({
+  const { styles, isLoading: isLoadingStyles, agentName, persistAnonymousConversations, welcomeMessage } = useCopilotStyles({
     productId,
     apiUrl,
     propStyles,
@@ -2720,6 +2789,8 @@ function CrowCopilot({
   const chat = useChat({
     productId,
     apiUrl,
+    persistAnonymousConversations,
+    welcomeMessage,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },