@factorialco/f0-react 1.408.0 → 1.410.0

package/dist/ai.d.ts

@@ -26,6 +26,8 @@ export declare const actionItemStatuses: readonly ["inProgress", "executing", "c
 
 /* Excluded from this release type: AgentState */
 
+export declare type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
+
 /**
  * Disclaimer configuration for the chat input
  */
@@ -60,6 +62,13 @@ export declare type AiChatProviderProps = {
      * @default false
      */
     lockVisualizationMode?: boolean;
+    /**
+     * Enable chat history UI (clickable header title + history dialog).
+     * When false (default), the header shows a simple "New Chat" button instead.
+     * Set to true only when the backend supports the /copilotkit/chat-history/threads route.
+     * @default false
+     */
+    historyEnabled?: boolean;
     /**
      * Optional footer content rendered below the textarea
      */
@@ -122,6 +131,18 @@ declare type AiChatProviderReturnValue = {
      */
     clear: () => void;
     /* Excluded from this release type: setClearFunction */
+    /**
+     * Title of the currently loaded thread, or null for new conversations
+     */
+    currentThreadTitle: string | null;
+    /**
+     * Load a thread by ID and set its title in the header
+     */
+    loadThread: (threadId: string, title: string) => void;
+    /* Excluded from this release type: setLoadThreadFunction */
+    /** Whether a thread's messages are currently being fetched */
+    isLoadingThread: boolean;
+    /* Excluded from this release type: setIsLoadingThread */
     /**
      * Send a message to the chat
      * @param message - The message content as a string, or a full Message object
@@ -149,6 +170,7 @@ declare type AiChatProviderReturnValue = {
      * When true, prevents switching between visualization modes
      */
     lockVisualizationMode: boolean;
+    historyEnabled: boolean;
     /**
      * Optional footer content rendered below the textarea
      */
@@ -158,10 +180,22 @@ declare type AiChatProviderReturnValue = {
      */
     setFooter: React.Dispatch<React.SetStateAction<React.ReactNode | undefined>>;
 } & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityResolvers" | "toolHints"> & {
+    /** The current canvas content, or null when canvas is closed */
+    canvasContent: CanvasContent | null;
+    /** The dashboard config from the current canvas content, or null */
+    canvasDashboard: ChatDashboardConfig | null;
+    /** Open the canvas panel with the given content */
+    openCanvas: (content: CanvasContent) => void;
+    /** Close the canvas panel and restore the previous visualization mode */
+    closeCanvas: () => void;
     /** The currently active tool hint, or null if none is selected */
     activeToolHint: AiChatToolHint | null;
     /** Set the active tool hint (pass null to clear) */
     setActiveToolHint: React.Dispatch<React.SetStateAction<AiChatToolHint | null>>;
+    /** Get a saved dashboard config by toolCallId (returns updated config after user edits) */
+    getSavedDashboardConfig: (toolCallId: string) => ChatDashboardConfig | undefined;
+    /** Save an updated dashboard config keyed by toolCallId */
+    updateDashboardConfig: (toolCallId: string, config: ChatDashboardConfig) => void;
 };
 
 /**
@@ -177,6 +211,7 @@ declare interface AiChatState {
     resizable?: boolean;
     defaultVisualizationMode?: VisualizationMode;
     lockVisualizationMode?: boolean;
+    historyEnabled?: boolean;
     footer?: React.ReactNode;
     entityResolvers?: EntityResolvers;
     toolHints?: AiChatToolHint[];
@@ -259,6 +294,9 @@ export declare const aiTranslations: {
         thoughtsGroupTitle: string;
         resourcesGroupTitle: string;
         thinking: string;
+        closeDashboard: string;
+        exportTable: string;
+        generatedTableFilename: string;
         feedbackModal: {
             positive: {
                 title: string;
@@ -274,22 +312,229 @@ export declare const aiTranslations: {
         dataDownloadPreview: string;
         expandChat: string;
         collapseChat: string;
+        chatHistory: string;
+        noPreviousChats: string;
+        newConversation: string;
+        today: string;
+        yesterday: string;
+        thisMonth: string;
+        older: string;
+        searchChats: string;
+        pinnedChats: string;
+        threadOptions: string;
+        pinChat: string;
+        unpinChat: string;
+        deleteChat: string;
         ask: string;
         viewProfile: string;
         tools: string;
+        reportCard: {
+            reportLabel: string;
+            openButton: string;
+        };
+        dataDownload: {
+            download: string;
+        };
+        unsavedChanges: string;
+        saveChanges: string;
+        discardChanges: string;
     };
 };
 
 export declare function Blockquote({ children, ...props }: React.HTMLAttributes<HTMLQuoteElement>): JSX_2.Element;
 
+/**
+ * Discriminated union for canvas panel content.
+ * Expand this union to support new content types in the canvas.
+ */
+export declare type CanvasContent = {
+    type: "dashboard";
+    title: string;
+    config: ChatDashboardConfig;
+    apiConfig: {
+        baseUrl: string;
+        headers: Record<string, string>;
+    };
+    toolCallId?: string;
+};
+
+export declare interface ChartComputation {
+    datasetId: string;
+    xAxis: string;
+    yAxis: string;
+    aggregation: AggregationType;
+    series?: string;
+    sortBy?: "value" | "category";
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+}
+
+export declare interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
+    type: "bar";
+    orientation?: "vertical" | "horizontal";
+    stacked?: boolean;
+}
+
+export declare type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig;
+
+declare interface ChatDashboardChartConfigBase {
+    showLegend?: boolean;
+    showGrid?: boolean;
+    showLabels?: boolean;
+    valueFormat?: FormatPreset;
+}
+
+export declare interface ChatDashboardChartItem extends ChatDashboardItemBase {
+    type: "chart";
+    chart: ChatDashboardChartConfig;
+    computation: ChartComputation | RadarComputation | PieComputation | GaugeComputation | HeatmapComputation;
+}
+
+export declare interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
+    type: "collection";
+    columns: ChatDashboardColumn[];
+    computation: CollectionComputation;
+}
+
+export declare interface ChatDashboardColumn {
+    /** Column key — must match a key in each row object */
+    id: string;
+    /** Display header label */
+    label: string;
+    /** Optional fixed width in pixels */
+    width?: number;
+}
+
+/**
+ * Complete dashboard configuration received via `displayDashboard`.
+ * Contains fetchSpecs that describe how to obtain data server-side —
+ * no raw data is included. Fully JSON-serializable.
+ */
+export declare interface ChatDashboardConfig {
+    /** Dashboard title displayed in the canvas header and chat report card */
+    title: string;
+    /** Filter definitions — keys become filter IDs */
+    filters?: Record<string, ChatDashboardFilterDefinition>;
+    /** Ordered list of dashboard items with computation specs */
+    items: ChatDashboardItem[];
+    /** Fetch specs for server-side data retrieval, keyed by datasetId */
+    fetchSpecs: Record<string, DashboardFetchSpec>;
+}
+
+export declare interface ChatDashboardFilterDefinition {
+    type: "in";
+    label: string;
+    column: string;
+    datasetId: string;
+}
+
+export declare interface ChatDashboardFunnelChartConfig {
+    type: "funnel";
+    sort?: "descending" | "ascending" | "none";
+    orient?: "horizontal" | "vertical";
+    labelPosition?: "inside" | "outside";
+    showLegend?: boolean;
+    showLabels?: boolean;
+    showConversion?: boolean;
+    valueFormat?: FormatPreset;
+}
+
+declare interface ChatDashboardGaugeChartConfig {
+    type: "gauge";
+    min?: number;
+    max?: number;
+    showValue?: boolean;
+    valueFormat?: FormatPreset;
+}
+
+declare interface ChatDashboardHeatmapChartConfig {
+    type: "heatmap";
+    min?: number;
+    max?: number;
+    showLabels?: boolean;
+    showVisualMap?: boolean;
+    valueFormat?: FormatPreset;
+}
+
+export declare type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
+
+declare interface ChatDashboardItemBase {
+    id: string;
+    title: string;
+    description?: string;
+    /** Source attribution shown as a subtitle (e.g. "Based on 8 feedbacks from 3 evaluators") */
+    sourceDescription?: string;
+    colSpan?: number;
+    rowSpan?: number;
+    x?: number;
+    y?: number;
+}
+
+export declare interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
+    type: "line";
+    lineType?: "linear" | "smooth" | "step";
+    showArea?: boolean;
+    showDots?: boolean;
+}
+
+export declare type ChatDashboardMetricFormat = {
+    type: "number";
+} | {
+    type: "currency";
+    currency?: string;
+} | {
+    type: "percent";
+} | {
+    type: "custom";
+    suffix?: string;
+    prefix?: string;
+};
+
+export declare interface ChatDashboardMetricItem extends ChatDashboardItemBase {
+    type: "metric";
+    format?: ChatDashboardMetricFormat;
+    decimals?: number;
+    computation: MetricComputation;
+}
+
+declare interface ChatDashboardPieChartConfig {
+    type: "pie";
+    innerRadius?: number;
+    showLegend?: boolean;
+    showLabels?: boolean;
+    showPercentage?: boolean;
+    valueFormat?: FormatPreset;
+}
+
+declare interface ChatDashboardRadarChartConfig extends ChatDashboardChartConfigBase {
+    type: "radar";
+    showArea?: boolean;
+}
+
 export declare const ChatSpinner: ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & RefAttributes<SVGSVGElement>>;
 
+export declare interface CollectionComputation {
+    datasetId: string;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+}
+
 /**
  * CSS RGB color string type
  * @example 'rgb(255, 0, 0)' or 'rgb(255,0,0)'
  */
 export declare type CSSRgbString = `rgb(${number}, ${number}, ${number})` | `rgb(${number},${number},${number})`;
 
+export declare interface DashboardFetchSpec {
+    fetch: Array<{
+        toolId: string;
+        args: Record<string, unknown>;
+    }>;
+    query: string | null;
+    columnLabels?: Record<string, string>;
+}
+
 export declare const defaultTranslations: {
     readonly countries: {
         ad: string;
@@ -660,6 +905,10 @@ export declare const defaultTranslations: {
         readonly thoughtsGroupTitle: "Reflection";
         readonly resourcesGroupTitle: "Resources";
         readonly thinking: "Thinking...";
+        readonly closeDashboard: "Close dashboard";
+        readonly unsavedChanges: "Unsaved changes";
+        readonly saveChanges: "Save changes";
+        readonly discardChanges: "Discard";
         readonly exportTable: "Download table";
         readonly generatedTableFilename: "OneGeneratedTable";
         readonly feedbackModal: {
@@ -677,9 +926,29 @@ export declare const defaultTranslations: {
         readonly dataDownloadPreview: "Preview {{shown}} of {{total}} rows — download the Excel to see all data.";
         readonly expandChat: "Expand chat";
         readonly collapseChat: "Collapse chat";
+        readonly chatHistory: "Chat history";
+        readonly noPreviousChats: "No previous conversations";
+        readonly newConversation: "New conversation";
+        readonly today: "Today";
+        readonly yesterday: "Yesterday";
+        readonly thisMonth: "This month";
+        readonly older: "Older";
+        readonly searchChats: "Search conversations...";
+        readonly pinnedChats: "Pinned";
+        readonly threadOptions: "Thread options";
+        readonly pinChat: "Pin chat";
+        readonly unpinChat: "Unpin chat";
+        readonly deleteChat: "Delete chat";
         readonly ask: "Ask One";
         readonly viewProfile: "View profile";
         readonly tools: "Tools";
+        readonly reportCard: {
+            readonly reportLabel: "Report";
+            readonly openButton: "Open";
+        };
+        readonly dataDownload: {
+            readonly download: "Download {{format}}";
+        };
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -967,7 +1236,7 @@ export declare const F0AiChat: () => JSX_2.Element | null;
 /**
  * @experimental This is an experimental component use it at your own risk
  */
-export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, footer, entityResolvers, toolHints, onThumbsUp, onThumbsDown, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, entityResolvers, toolHints, onThumbsUp, onThumbsDown, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
 
 export declare const F0AiChatTextArea: ({ submitLabel, inProgress, onSend, onStop, placeholders, defaultPlaceholder, autoFocus, entityResolvers, toolHints, activeToolHint, onActiveToolHintChange, }: F0AiChatTextAreaProps) => JSX_2.Element;
 
@@ -1103,6 +1372,31 @@ declare const F0AuraVoiceAnimationVariants: (props?: ({
     className?: ClassValue;
 })) | undefined) => string;
 
+/**
+ * Compact card shown inline in the AI chat to represent a generated
+ * dashboard report. Uses F0Card with an icon avatar, the dashboard
+ * title/description, and an item summary in metadata. Clicking the
+ * card triggers `onView` to open the canvas panel.
+ *
+ * Subscribes to the external `savedDashboardConfigStore` via
+ * `useSyncExternalStore` so it re-renders when the user edits the
+ * dashboard layout and saves — independently of React context.
+ */
+export declare function F0ChatReportCard({ config: originalConfig, onView, toolCallId, }: F0ChatReportCardProps): JSX_2.Element;
+
+export declare namespace F0ChatReportCard {
+    var displayName: string;
+}
+
+export declare interface F0ChatReportCardProps {
+    /** The original dashboard config from the agent */
+    config: ChatDashboardConfig;
+    /** Callback when the user clicks the card to view the report */
+    onView: (config: ChatDashboardConfig) => void;
+    /** Tool call ID used to look up saved (edited) dashboard configs */
+    toolCallId?: string;
+}
+
 /**
  * Component that renders an optional markdown preview followed by
  * a dropdown button with "Download Excel" as the primary action and
@@ -1310,6 +1604,22 @@ export declare type F0ThinkingProps = {
     title?: string;
 };
 
+/**
+ * A preset formatting instruction the LLM can specify instead of a
+ * real formatter function. The wrapper component maps these to actual
+ * `(value: number) => string` functions at render time.
+ */
+export declare type FormatPreset = {
+    type: "number";
+} | {
+    type: "currency";
+    currency?: string;
+} | {
+    type: "percent";
+} | {
+    type: "compact";
+};
+
 export declare const FullscreenChatContext: Context<FullscreenChatContextType>;
 
 /**
@@ -1320,12 +1630,29 @@ declare type FullscreenChatContextType = {
     setInProgress: (value: boolean) => void;
 };
 
+declare interface GaugeComputation {
+    datasetId: string;
+    aggregation: AggregationType;
+    column?: string;
+    min?: number;
+    max?: number;
+    name?: string;
+}
+
 export declare function H1({ children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): JSX_2.Element;
 
 export declare function H2({ children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): JSX_2.Element;
 
 export declare function H3({ children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): JSX_2.Element;
 
+declare interface HeatmapComputation {
+    datasetId: string;
+    xAxis: string;
+    yAxis: string;
+    valueColumn: string;
+    aggregation: AggregationType;
+}
+
 export declare function Hr({ ...props }: React.HTMLAttributes<HTMLHRElement>): JSX_2.Element;
 
 export declare function I18nProvider({ children, translations, }: I18nProviderProps): JSX.Element;
@@ -1402,6 +1729,12 @@ export declare type MaskOptions = {
     styles?: Partial<CSSStyleDeclaration>;
 };
 
+export declare interface MetricComputation {
+    datasetId: string;
+    aggregation: AggregationType;
+    column?: string;
+}
+
 export declare function Ol({ children, ...props }: React.HTMLAttributes<HTMLOListElement>): JSX_2.Element;
 
 export declare type OneIconSize = (typeof oneIconSizes)[number];
@@ -1426,8 +1759,31 @@ export declare type PersonProfile = {
     jobTitle?: string;
 };
 
+declare interface PieComputation {
+    datasetId: string;
+    nameColumn: string;
+    valueColumn: string;
+    aggregation: AggregationType;
+    sortBy?: "value" | "name";
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+}
+
 export declare function Pre({ children, ...props }: React.HTMLAttributes<HTMLPreElement>): JSX_2.Element;
 
+declare interface RadarComputation {
+    datasetId: string;
+    seriesColumn: string;
+    indicators: Array<{
+        column: string;
+        label: string;
+        max?: number;
+    }>;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+}
+
 export declare function Strong({ children, ...props }: React.HTMLAttributes<HTMLSpanElement>): JSX_2.Element;
 
 export declare function Table({ children, ...props }: React.HTMLAttributes<HTMLTableElement>): JSX_2.Element;
@@ -1495,7 +1851,7 @@ export declare const useOrchestratorThinkingAction: () => void;
 /**
  * Visualization mode for the AI chat
  */
-export declare type VisualizationMode = "sidepanel" | "fullscreen";
+export declare type VisualizationMode = "sidepanel" | "fullscreen" | "canvas";
 
 /**
  * Welcome screen suggestion item
@@ -1546,6 +1902,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -1593,8 +1954,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}

package/dist/ai.js

@@ -1,54 +1,56 @@
-import { A as e, B as t, C as i, q as n, E as o, h as r, F as l, a as A, D as c, i as F, b as u, j as h, w as C, x as d, y as m, z as T, c as f, r as S, s as p, t as I, H as g, I as k, m as x, L as H, O as M, v as P, P as b, S as w, T as O, n as v, o as D, p as E, U as L, k as R, l as q, d as y, e as z, u as B, g as U, f as j } from "./F0AiChat-B5pShue-.js";
-import { defaultTranslations as G } from "./i18n-provider-defaults.js";
-import { A as K, F as N, c as Q, d as W, b as X, a as Y, o as Z, u as _ } from "./F0HILActionConfirmation-Cud7NMip.js";
+import { I as e, u as t } from "./F0Input-JjjfHKNJ.js";
+import { defaultTranslations as i } from "./i18n-provider-defaults.js";
+import { A as r, B as l, C as A, p as F, E as c, g as u, F as h, a as C, z as d, h as m, b as T, i as f, j as p, v as I, w as S, x as g, y as k, c as x, q as H, r as M, s as P, H as b, I as w, L as O, O as v, t as R, P as D, S as E, T as L, m as q, n as y, o as z, U as B, k as U, l as j, u as V, d as G, f as J, e as K } from "./F0AiChat-B75wNcO_.js";
+import { A as Q, F as W, c as X, d as Y, b as Z, a as _, o as $, u as aa } from "./F0HILActionConfirmation-CasXGy89.js";
 export {
-  e as A,
-  K as AiChatTranslationsProvider,
-  t as Blockquote,
-  i as ChatSpinner,
-  n as Em,
-  o as EntityRef,
-  r as F0ActionItem,
-  l as F0AiChat,
-  A as F0AiChatProvider,
-  c as F0AiChatTextArea,
-  F as F0AiCollapsibleMessage,
-  u as F0AiFullscreenChat,
-  N as F0AiMask,
-  Q as F0AuraVoiceAnimation,
-  h as F0DataDownload,
-  W as F0HILActionConfirmation,
-  C as F0MessageSources,
-  d as F0OneIcon,
-  m as F0OneSwitch,
-  T as F0Thinking,
-  f as FullscreenChatContext,
-  S as H1,
-  p as H2,
-  I as H3,
-  g as Hr,
-  k as I18nProvider,
-  x as Image,
-  H as Li,
-  M as Ol,
-  P,
-  b as Pre,
-  w as Strong,
-  O as Table,
-  v as TableSimple,
-  D as Td,
-  E as Th,
-  L as Ul,
-  X as actionItemStatuses,
-  Y as aiTranslations,
-  G as defaultTranslations,
-  R as f0MarkdownRenderers,
-  q as f0MarkdownRenderersSimple,
-  Z as oneIconSizes,
-  y as useAiChat,
-  _ as useAiChatTranslations,
-  z as useDefaultCopilotActions,
-  B as useI18n,
-  U as useMessageSourcesAction,
-  j as useOrchestratorThinkingAction
+  r as A,
+  Q as AiChatTranslationsProvider,
+  l as Blockquote,
+  A as ChatSpinner,
+  F as Em,
+  c as EntityRef,
+  u as F0ActionItem,
+  h as F0AiChat,
+  C as F0AiChatProvider,
+  d as F0AiChatTextArea,
+  m as F0AiCollapsibleMessage,
+  T as F0AiFullscreenChat,
+  W as F0AiMask,
+  X as F0AuraVoiceAnimation,
+  f as F0ChatReportCard,
+  p as F0DataDownload,
+  Y as F0HILActionConfirmation,
+  I as F0MessageSources,
+  S as F0OneIcon,
+  g as F0OneSwitch,
+  k as F0Thinking,
+  x as FullscreenChatContext,
+  H as H1,
+  M as H2,
+  P as H3,
+  b as Hr,
+  e as I18nProvider,
+  w as Image,
+  O as Li,
+  v as Ol,
+  R as P,
+  D as Pre,
+  E as Strong,
+  L as Table,
+  q as TableSimple,
+  y as Td,
+  z as Th,
+  B as Ul,
+  Z as actionItemStatuses,
+  _ as aiTranslations,
+  i as defaultTranslations,
+  U as f0MarkdownRenderers,
+  j as f0MarkdownRenderersSimple,
+  $ as oneIconSizes,
+  V as useAiChat,
+  aa as useAiChatTranslations,
+  G as useDefaultCopilotActions,
+  t as useI18n,
+  J as useMessageSourcesAction,
+  K as useOrchestratorThinkingAction
 };