@usecrow/ui 0.1.32 → 0.1.34

package/dist/index.d.cts

@@ -187,6 +187,15 @@ interface WidgetConfigResponse {
     welcomeMessage?: string | null;
     /** AI model to use for this product */
     model?: string;
+    /** Whether page navigation is enabled for this product */
+    pageNavigationEnabled?: boolean;
+    /** Route definitions for page navigation */
+    pageNavigationRoutes?: Array<{
+        name: string;
+        path: string;
+        description?: string;
+        params?: Record<string, string>;
+    }>;
 }
 
 /** Identity data passed to the identify function */
@@ -230,10 +239,12 @@ interface CrowWidgetProps {
     onIdentify?: (identify: IdentifyFunction) => void;
     /** Client-side tools the agent can call */
     tools?: ToolsMap;
+    /** Custom navigation function for SPA-safe page navigation (e.g. router.push from Next.js or React Router) */
+    navigate?: (path: string) => void;
     /** Callback fired when a server-side tool completes, with the tool name and full result data */
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, onToolResult, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -266,10 +277,12 @@ interface CrowCopilotProps {
     className?: string;
     /** Callback when copilot is ready */
     onReady?: () => void;
+    /** Custom navigation function for SPA-safe page navigation (e.g. router.push from Next.js or React Router) */
+    navigate?: (path: string) => void;
     /** Callback fired when a server-side tool completes, with the tool name and full result data */
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
 }
-declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, onToolResult, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -663,6 +676,15 @@ interface UseWidgetStylesResult {
     agentName: string;
     /** Whether browser_use is enabled for this product */
     browserUseEnabled: boolean;
+    /** Whether page navigation is enabled for this product */
+    pageNavigationEnabled: boolean;
+    /** Route definitions for page navigation */
+    pageNavigationRoutes: Array<{
+        name: string;
+        path: string;
+        description?: string;
+        params?: Record<string, string>;
+    }>;
     /** Whether to show thinking/reasoning to users */
     showThinking: boolean;
     /** Whether to persist anonymous conversations across page refreshes (undefined while loading) */
@@ -695,10 +717,21 @@ interface UseCopilotStylesResult {
     error: Error | null;
     /** Agent name from product config */
     agentName: string;
+    /** Whether page navigation is enabled for this product */
+    pageNavigationEnabled: boolean;
+    /** Route definitions for page navigation */
+    pageNavigationRoutes: Array<{
+        name: string;
+        path: string;
+        description?: string;
+        params?: Record<string, 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;
+    /** AI model configured for this product */
+    selectedModel: string | undefined;
     /** Refetch styles from API */
     refetch: () => Promise<void>;
 }

package/dist/index.d.ts

@@ -187,6 +187,15 @@ interface WidgetConfigResponse {
     welcomeMessage?: string | null;
     /** AI model to use for this product */
     model?: string;
+    /** Whether page navigation is enabled for this product */
+    pageNavigationEnabled?: boolean;
+    /** Route definitions for page navigation */
+    pageNavigationRoutes?: Array<{
+        name: string;
+        path: string;
+        description?: string;
+        params?: Record<string, string>;
+    }>;
 }
 
 /** Identity data passed to the identify function */
@@ -230,10 +239,12 @@ interface CrowWidgetProps {
     onIdentify?: (identify: IdentifyFunction) => void;
     /** Client-side tools the agent can call */
     tools?: ToolsMap;
+    /** Custom navigation function for SPA-safe page navigation (e.g. router.push from Next.js or React Router) */
+    navigate?: (path: string) => void;
     /** Callback fired when a server-side tool completes, with the tool name and full result data */
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, onToolResult, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -266,10 +277,12 @@ interface CrowCopilotProps {
     className?: string;
     /** Callback when copilot is ready */
     onReady?: () => void;
+    /** Custom navigation function for SPA-safe page navigation (e.g. router.push from Next.js or React Router) */
+    navigate?: (path: string) => void;
     /** Callback fired when a server-side tool completes, with the tool name and full result data */
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
 }
-declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, onToolResult, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -663,6 +676,15 @@ interface UseWidgetStylesResult {
     agentName: string;
     /** Whether browser_use is enabled for this product */
     browserUseEnabled: boolean;
+    /** Whether page navigation is enabled for this product */
+    pageNavigationEnabled: boolean;
+    /** Route definitions for page navigation */
+    pageNavigationRoutes: Array<{
+        name: string;
+        path: string;
+        description?: string;
+        params?: Record<string, string>;
+    }>;
     /** Whether to show thinking/reasoning to users */
     showThinking: boolean;
     /** Whether to persist anonymous conversations across page refreshes (undefined while loading) */
@@ -695,10 +717,21 @@ interface UseCopilotStylesResult {
     error: Error | null;
     /** Agent name from product config */
     agentName: string;
+    /** Whether page navigation is enabled for this product */
+    pageNavigationEnabled: boolean;
+    /** Route definitions for page navigation */
+    pageNavigationRoutes: Array<{
+        name: string;
+        path: string;
+        description?: string;
+        params?: Record<string, 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;
+    /** AI model configured for this product */
+    selectedModel: string | undefined;
     /** Refetch styles from API */
     refetch: () => Promise<void>;
 }

package/dist/index.js

@@ -1164,6 +1164,10 @@ function useWidgetStyles({
   const [browserUseEnabled, setBrowserUseEnabled] = useState(
     styleCache.get(key)?.browserUseEnabled || false
   );
+  const [pageNavigationEnabled, setPageNavigationEnabled] = useState(
+    styleCache.get(key)?.pageNavigationEnabled || false
+  );
+  const [pageNavigationRoutes, setPageNavigationRoutes] = useState(styleCache.get(key)?.pageNavigationRoutes || []);
   const [showThinking, setShowThinking] = useState(
     styleCache.get(key)?.showThinking ?? true
   );
@@ -1187,6 +1191,8 @@ function useWidgetStyles({
       setDbStyles(config.widgetStyles);
       setAgentName(config.agentName || "Assistant");
       setBrowserUseEnabled(config.browserUseEnabled || false);
+      setPageNavigationEnabled(config.pageNavigationEnabled || false);
+      setPageNavigationRoutes(config.pageNavigationRoutes || []);
       setShowThinking(config.showThinking ?? true);
       setPersistAnonymousConversations(config.persistAnonymousConversations ?? true);
       setWelcomeMessage(config.welcomeMessage ?? void 0);
@@ -1222,6 +1228,8 @@ function useWidgetStyles({
     error,
     agentName,
     browserUseEnabled,
+    pageNavigationEnabled,
+    pageNavigationRoutes,
     showThinking,
     persistAnonymousConversations,
     welcomeMessage,
@@ -1245,12 +1253,19 @@ function useCopilotStyles({
   const [agentName, setAgentName] = useState(
     styleCache.get(key)?.agentName || "Assistant"
   );
+  const [pageNavigationEnabled, setPageNavigationEnabled] = useState(
+    styleCache.get(key)?.pageNavigationEnabled || false
+  );
+  const [pageNavigationRoutes, setPageNavigationRoutes] = useState(styleCache.get(key)?.pageNavigationRoutes || []);
   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 [selectedModel, setSelectedModel] = useState(
+    styleCache.get(key)?.model ?? void 0
+  );
   const hasFetchedRef = useRef(false);
   const fetchStyles = async () => {
     if (skip) return;
@@ -1261,8 +1276,11 @@ function useCopilotStyles({
       styleCache.set(key, config);
       setDbStyles(config.copilotStyles);
       setAgentName(config.agentName || "Assistant");
+      setPageNavigationEnabled(config.pageNavigationEnabled || false);
+      setPageNavigationRoutes(config.pageNavigationRoutes || []);
       setPersistAnonymousConversations(config.persistAnonymousConversations ?? true);
       setWelcomeMessage(config.welcomeMessage ?? void 0);
+      setSelectedModel(config.model ?? void 0);
     } catch (err) {
       console.error("[CrowCopilot] Failed to fetch styles:", err);
       setError(err instanceof Error ? err : new Error(String(err)));
@@ -1276,8 +1294,11 @@ function useCopilotStyles({
     if (cached) {
       setDbStyles(cached.copilotStyles);
       setAgentName(cached.agentName || "Assistant");
+      setPageNavigationEnabled(cached.pageNavigationEnabled || false);
+      setPageNavigationRoutes(cached.pageNavigationRoutes || []);
       setPersistAnonymousConversations(cached.persistAnonymousConversations ?? true);
       setWelcomeMessage(cached.welcomeMessage ?? void 0);
+      setSelectedModel(cached.model ?? void 0);
       setIsLoading(false);
       return;
     }
@@ -1290,8 +1311,11 @@ function useCopilotStyles({
     isLoading,
     error,
     agentName,
+    pageNavigationEnabled,
+    pageNavigationRoutes,
     persistAnonymousConversations,
     welcomeMessage,
+    selectedModel,
     refetch: fetchStyles
   };
 }
@@ -2836,6 +2860,7 @@ function CrowWidget({
   onReady,
   onIdentify,
   tools,
+  navigate,
   onToolResult
 }) {
   const {
@@ -2843,6 +2868,8 @@ function CrowWidget({
     isLoading: isLoadingStyles,
     agentName: agentNameFromAPI,
     browserUseEnabled,
+    pageNavigationEnabled,
+    pageNavigationRoutes,
     showThinking: showThinkingFromAPI,
     persistAnonymousConversations,
     welcomeMessage: welcomeMessageFromAPI,
@@ -3048,17 +3075,33 @@ function CrowWidget({
     };
   }, [handleBrowserConfirmation, handleBrowserQuestion, handleBrowserProgress]);
   useEffect(() => {
-    if (browserUseEnabled && !isLoadingStyles && Object.keys(autoTools).length === 0) {
+    if (browserUseEnabled && !isLoadingStyles && !autoTools.browser_use) {
       import('@usecrow/client/browser').then(({ createBrowserUseTool }) => {
-        setAutoTools({
+        setAutoTools((prev) => ({
+          ...prev,
           browser_use: createBrowserUseTool({ productId, apiUrl })
-        });
+        }));
         console.log("[Crow] browser_use tool auto-loaded");
       }).catch((err) => {
         console.warn("[Crow] Failed to load browser_use:", err);
       });
     }
   }, [browserUseEnabled, isLoadingStyles, productId, apiUrl, autoTools]);
+  useEffect(() => {
+    if (pageNavigationEnabled && pageNavigationRoutes.length > 0 && !isLoadingStyles) {
+      import('@usecrow/client').then(({ createNavigateToPageTool }) => {
+        setAutoTools((prev) => ({
+          ...prev,
+          navigateToPage: createNavigateToPageTool(pageNavigationRoutes, navigate)
+        }));
+        console.log(
+          `[Crow] navigateToPage tool auto-loaded with ${pageNavigationRoutes.length} routes`
+        );
+      }).catch((err) => {
+        console.warn("[Crow] Failed to load navigateToPage:", err);
+      });
+    }
+  }, [pageNavigationEnabled, pageNavigationRoutes, isLoadingStyles, navigate]);
   const mergedTools = useMemo(() => ({ ...autoTools, ...tools }), [autoTools, tools]);
   useEffect(() => {
     if (Object.keys(mergedTools).length > 0) {
@@ -3355,14 +3398,18 @@ function CrowCopilot({
   previewMode = false,
   className,
   onReady,
+  navigate,
   onToolResult
 }) {
   const {
     styles,
     isLoading: isLoadingStyles,
     agentName: agentNameFromAPI,
+    pageNavigationEnabled,
+    pageNavigationRoutes,
     persistAnonymousConversations,
-    welcomeMessage: welcomeMessageFromAPI
+    welcomeMessage: welcomeMessageFromAPI,
+    selectedModel
   } = useCopilotStyles({
     productId,
     apiUrl,
@@ -3371,9 +3418,31 @@ function CrowCopilot({
   });
   const agentName = agentNameProp ?? agentNameFromAPI ?? title;
   const welcomeMessage = welcomeMessageProp ?? welcomeMessageFromAPI;
+  const [autoTools, setAutoTools] = useState({});
+  useEffect(() => {
+    if (pageNavigationEnabled && pageNavigationRoutes.length > 0 && !isLoadingStyles) {
+      import('@usecrow/client').then(({ createNavigateToPageTool }) => {
+        setAutoTools((prev) => ({
+          ...prev,
+          navigateToPage: createNavigateToPageTool(pageNavigationRoutes, navigate)
+        }));
+        console.log(
+          `[Crow] navigateToPage tool auto-loaded with ${pageNavigationRoutes.length} routes`
+        );
+      }).catch((err) => {
+        console.warn("[Crow] Failed to load navigateToPage:", err);
+      });
+    }
+  }, [pageNavigationEnabled, pageNavigationRoutes, isLoadingStyles, navigate]);
+  useEffect(() => {
+    if (Object.keys(autoTools).length > 0) {
+      window.crow?.("registerTools", autoTools);
+    }
+  }, [autoTools]);
   const messagesContainerRef = useRef(null);
   const tabsScrollRef = useRef(null);
   const executeClientToolRef = useRef(null);
+  const submitToolResultRef = useRef(null);
   const [showConversationList, setShowConversationList] = useState(false);
   const [isVerifiedUser, setIsVerifiedUser] = useState(false);
   const [localTabs, setLocalTabs] = useState([
@@ -3392,24 +3461,71 @@ function CrowCopilot({
     apiUrl,
     persistAnonymousConversations,
     welcomeMessage,
+    selectedModel,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },
     onConversationId: () => {
     },
+    onWorkflowEvent: (event) => {
+      switch (event.type) {
+        case "started":
+          if (event.name && event.todos) {
+            startWorkflow(event.name, event.todos);
+          }
+          break;
+        case "todo_updated":
+          if (event.todoId && event.todoStatus) {
+            updateTodo(event.todoId, event.todoStatus);
+          }
+          break;
+        case "ended":
+          endWorkflow(2e3);
+          break;
+        case "complete_prompt":
+          markComplete();
+          break;
+      }
+    },
     onToolResult,
-    onToolCall: (event) => {
-      if (event.type === "client_call" && event.toolName) {
-        console.log(
-          "[Crow Copilot] Executing client tool:",
-          event.toolName,
-          event.arguments
-        );
-        const result = executeClientToolRef.current?.(
-          event.toolName,
-          event.arguments || {}
-        );
-        result?.then((r) => console.log("[Crow Copilot] Tool result:", r)).catch((e) => console.error("[Crow Copilot] Tool error:", e));
+    onToolCall: async (event) => {
+      if (event.type === "client_call" && event.toolName && event.toolCallId) {
+        try {
+          const result = await executeClientToolRef.current?.(
+            event.toolName,
+            event.arguments || {}
+          );
+          const resultObj = result;
+          const dataObj = resultObj?.data;
+          const wasUserCancelled = dataObj?.declined === true || typeof resultObj?.error === "string" && resultObj.error.includes("cancelled by user") || typeof resultObj?.error === "string" && resultObj.error.includes("declined");
+          if (wasUserCancelled) {
+            console.log("[Crow Copilot] Tool was cancelled by user");
+            if (submitToolResultRef.current) {
+              await submitToolResultRef.current(
+                event.toolCallId,
+                event.toolName,
+                { success: false, cancelled: true, error: "Action was cancelled by the user." }
+              );
+            }
+            return;
+          }
+          if (result && submitToolResultRef.current) {
+            await submitToolResultRef.current(
+              event.toolCallId,
+              event.toolName,
+              result
+            );
+          }
+        } catch (e) {
+          console.error("[Crow Copilot] Tool error:", e);
+          if (submitToolResultRef.current) {
+            await submitToolResultRef.current(
+              event.toolCallId,
+              event.toolName,
+              { success: false, error: String(e) }
+            );
+          }
+        }
       }
     },
     onRestoredConversation: () => {
@@ -3431,6 +3547,30 @@ function CrowCopilot({
       injectCopilotBodyStyles();
     }
   }, [variant]);
+  const {
+    activeWorkflow,
+    startWorkflow,
+    updateTodo,
+    markComplete,
+    endWorkflow,
+    exitWorkflow
+  } = useWorkflow({
+    productId,
+    apiUrl,
+    conversationId: chat.conversationId,
+    selectedModel: chat.selectedModel,
+    onMessage: (content) => {
+      chat.loadMessages([
+        ...chat.messages,
+        {
+          id: `bot-${Date.now()}`,
+          content,
+          isBot: true,
+          timestamp: /* @__PURE__ */ new Date()
+        }
+      ]);
+    }
+  });
   const { executeClientTool } = useCrowAPI({
     onIdentified: async () => {
       setIsVerifiedUser(true);
@@ -3442,6 +3582,7 @@ function CrowCopilot({
     }
   });
   executeClientToolRef.current = executeClientTool;
+  submitToolResultRef.current = chat.submitToolResult;
   const handleBrowserConfirmation = useCallback(
     (instruction) => {
       return new Promise((resolve) => {
@@ -3458,6 +3599,9 @@ function CrowCopilot({
     },
     []
   );
+  const handleExitWorkflow = async () => {
+    await exitWorkflow();
+  };
   useEffect(() => {
     window.__crow_browser_callbacks = {
       onConfirmation: handleBrowserConfirmation,
@@ -3783,6 +3927,13 @@ function CrowCopilot({
               ),
               showConversationList && !isVerifiedUser && /* @__PURE__ */ jsx("div", { className: "crow-mb-3 crow-rounded-xl crow-bg-gray-50 crow-border crow-border-gray-200 crow-p-4", children: /* @__PURE__ */ jsx("div", { className: "crow-text-sm crow-text-gray-600", children: "Sign in to view conversation history." }) })
             ] }),
+            /* @__PURE__ */ jsx(AnimatePresence, { children: activeWorkflow && /* @__PURE__ */ jsx(
+              WorkflowPanel,
+              {
+                workflow: activeWorkflow,
+                onExit: handleExitWorkflow
+              }
+            ) }),
             /* @__PURE__ */ jsxs(MessagesContainer, { ref: messagesContainerRef, children: [
               /* @__PURE__ */ jsx(
                 MessageList,