@usecrow/ui 0.1.65 → 0.1.66

package/dist/index.d.cts

@@ -320,6 +320,7 @@ declare global {
         __crow_identity_token_fetcher?: () => Promise<string>;
         __crow_on_tool_result?: (toolName: string, result: Record<string, unknown>) => void;
         __crow_tool_renderers?: ToolRenderers;
+        __crow_context_label?: string;
     }
 }
 
@@ -396,8 +397,13 @@ interface CrowWidgetProps {
      * Appended after default styles, allowing overrides.
      */
     customCss?: string;
+    /**
+     * Label shown at the top of the widget indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, contextLabel: contextLabelProp, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -479,8 +485,13 @@ interface CrowCopilotProps {
      * responds in that language and the welcome message is translated.
      */
     language?: string;
+    /**
+     * Label shown at the top of the copilot indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, contextLabel: contextLabelProp, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -1183,8 +1194,10 @@ interface WidgetHeaderProps {
     hasCustomTransform?: boolean;
     /** Reset position & size to defaults */
     onResetTransform?: () => void;
+    /** Context label displayed below the header row */
+    contextLabel?: string;
 }
-declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
+declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, contextLabel, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * CopilotToggleButton - Edge toggle button for floating copilot

package/dist/index.d.ts

@@ -320,6 +320,7 @@ declare global {
         __crow_identity_token_fetcher?: () => Promise<string>;
         __crow_on_tool_result?: (toolName: string, result: Record<string, unknown>) => void;
         __crow_tool_renderers?: ToolRenderers;
+        __crow_context_label?: string;
     }
 }
 
@@ -396,8 +397,13 @@ interface CrowWidgetProps {
      * Appended after default styles, allowing overrides.
      */
     customCss?: string;
+    /**
+     * Label shown at the top of the widget indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, contextLabel: contextLabelProp, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -479,8 +485,13 @@ interface CrowCopilotProps {
      * responds in that language and the welcome message is translated.
      */
     language?: string;
+    /**
+     * Label shown at the top of the copilot indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, contextLabel: contextLabelProp, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -1183,8 +1194,10 @@ interface WidgetHeaderProps {
     hasCustomTransform?: boolean;
     /** Reset position & size to defaults */
     onResetTransform?: () => void;
+    /** Context label displayed below the header row */
+    contextLabel?: string;
 }
-declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
+declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, contextLabel, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * CopilotToggleButton - Edge toggle button for floating copilot

package/dist/index.js

@@ -1237,6 +1237,16 @@ function useCrowAPI({ onIdentified, onReset } = {}) {
           }
           return crowAsk(opts);
         }
+        case "setContextLabel":
+          if (typeof options !== "string") {
+            console.error("[Crow] setContextLabel() requires a string");
+            return;
+          }
+          window.__crow_context_label = options || void 0;
+          window.dispatchEvent(
+            new CustomEvent("crow:setContextLabel", { detail: options })
+          );
+          break;
         case "setSuggestedActions":
           if (!Array.isArray(options)) {
             console.error("[Crow] setSuggestedActions() requires an array of { label, message }");
@@ -2438,7 +2448,8 @@ function WidgetHeader({
   onDragPointerDown,
   isDragging,
   hasCustomTransform,
-  onResetTransform
+  onResetTransform,
+  contextLabel
 }) {
   const { agentName, styles } = useWidgetStyleContext();
   return /* @__PURE__ */ jsxs(
@@ -2526,7 +2537,36 @@ function WidgetHeader({
               children: /* @__PURE__ */ jsx(X, { size: 18, className: "crow-text-gray-700" })
             }
           )
-        ] })
+        ] }),
+        contextLabel && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "crow-flex crow-items-center crow-gap-1.5 crow-mt-1 crow-text-xs",
+            style: { color: "#6b7280" },
+            children: [
+              /* @__PURE__ */ jsxs(
+                "svg",
+                {
+                  xmlns: "http://www.w3.org/2000/svg",
+                  width: "12",
+                  height: "12",
+                  viewBox: "0 0 24 24",
+                  fill: "none",
+                  stroke: "currentColor",
+                  strokeWidth: "2",
+                  strokeLinecap: "round",
+                  strokeLinejoin: "round",
+                  className: "crow-shrink-0",
+                  children: [
+                    /* @__PURE__ */ jsx("path", { d: "M20 10c0 6-8 12-8 12s-8-6-8-12a8 8 0 0 1 16 0Z" }),
+                    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "10", r: "3" })
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsx("span", { className: "crow-truncate", children: contextLabel })
+            ]
+          }
+        )
       ]
     }
   );
@@ -4132,7 +4172,8 @@ function CrowWidget({
   context,
   toolRenderers,
   language,
-  customCss
+  customCss,
+  contextLabel: contextLabelProp
 }) {
   const effectiveGetIdentityToken = getIdentityToken || window.__crow_identity_token_fetcher;
   const effectiveOnToolResult = onToolResult || window.__crow_on_tool_result;
@@ -4173,6 +4214,15 @@ function CrowWidget({
     window.addEventListener("crow:setGreeting", handler);
     return () => window.removeEventListener("crow:setGreeting", handler);
   }, []);
+  const [contextLabelFromAPI, setContextLabelFromAPI] = useState(
+    () => window.__crow_context_label
+  );
+  useEffect(() => {
+    const handler = (e) => setContextLabelFromAPI(e.detail || void 0);
+    window.addEventListener("crow:setContextLabel", handler);
+    return () => window.removeEventListener("crow:setContextLabel", handler);
+  }, []);
+  const contextLabel = contextLabelProp ?? contextLabelFromAPI;
   const agentName = agentNameProp ?? agentNameFromAPI;
   const welcomeMessage = greetingOverride ?? welcomeMessageProp ?? welcomeMessageFromAPI;
   const selectedModel = selectedModelFromAPI;
@@ -4663,7 +4713,8 @@ function CrowWidget({
         onDragPointerDown: variant === "floating" ? transform.onDragPointerDown : void 0,
         isDragging: transform.isDragging,
         hasCustomTransform: transform.hasCustomTransform,
-        onResetTransform: transform.resetTransform
+        onResetTransform: transform.resetTransform,
+        contextLabel
       }
     ),
     /* @__PURE__ */ jsx(AnimatePresence, { children: showConversationList && isVerifiedUser && /* @__PURE__ */ jsx(
@@ -5055,7 +5106,8 @@ function CrowCopilot({
   toolRenderers,
   getIdentityToken,
   context,
-  language
+  language,
+  contextLabel: contextLabelProp
 }) {
   const effectiveGetIdentityToken = getIdentityToken || window.__crow_identity_token_fetcher;
   const effectiveOnToolResult = onToolResult || window.__crow_on_tool_result;
@@ -5096,6 +5148,15 @@ function CrowCopilot({
     return () => window.removeEventListener("crow:setGreeting", handler);
   }, []);
   const welcomeMessage = greetingOverride ?? welcomeMessageProp ?? welcomeMessageFromAPI;
+  const [contextLabelFromAPI, setContextLabelFromAPI] = useState(
+    () => window.__crow_context_label
+  );
+  useEffect(() => {
+    const handler = (e) => setContextLabelFromAPI(e.detail || void 0);
+    window.addEventListener("crow:setContextLabel", handler);
+    return () => window.removeEventListener("crow:setContextLabel", handler);
+  }, []);
+  const contextLabel = contextLabelProp ?? contextLabelFromAPI;
   const [autoTools, setAutoTools] = useState({});
   const browserUseLoaded = autoTools.browser_use;
   useEffect(() => {
@@ -5910,6 +5971,38 @@ function CrowCopilot({
                 ]
               }
             ),
+            contextLabel && /* @__PURE__ */ jsxs(
+              "div",
+              {
+                className: "crow-flex crow-items-center crow-gap-1.5 crow-px-3 crow-py-1.5 crow-border-b crow-text-xs",
+                style: {
+                  color: "#6b7280",
+                  borderColor: styles.colors.border
+                },
+                children: [
+                  /* @__PURE__ */ jsxs(
+                    "svg",
+                    {
+                      xmlns: "http://www.w3.org/2000/svg",
+                      width: "12",
+                      height: "12",
+                      viewBox: "0 0 24 24",
+                      fill: "none",
+                      stroke: "currentColor",
+                      strokeWidth: "2",
+                      strokeLinecap: "round",
+                      strokeLinejoin: "round",
+                      className: "crow-shrink-0",
+                      children: [
+                        /* @__PURE__ */ jsx("path", { d: "M20 10c0 6-8 12-8 12s-8-6-8-12a8 8 0 0 1 16 0Z" }),
+                        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "10", r: "3" })
+                      ]
+                    }
+                  ),
+                  /* @__PURE__ */ jsx("span", { className: "crow-truncate", children: contextLabel })
+                ]
+              }
+            ),
             /* @__PURE__ */ jsxs(AnimatePresence, { children: [
               showConversationList && isVerifiedUser && /* @__PURE__ */ jsx(
                 ConversationList,