@factorialco/f0-react 2.19.1 → 2.20.0

package/dist/ai.d.ts

@@ -5,6 +5,7 @@ import { baseColors } from '@factorialco/f0-core';
 import { ClassValue } from 'cva';
 import { CompanyItemProps } from './types';
 import { ComponentProps } from 'react';
+import { ComponentType } from 'react';
 import { CopilotKitProps } from '@copilotkit/react-core';
 import { EmployeeItemProps } from './types';
 import { F0TagBalanceProps as F0TagBalanceProps_2 } from './types';
@@ -14,7 +15,6 @@ import { F0TagTeamProps } from './types';
 import { f1Colors } from '@factorialco/f0-core';
 import { ForwardedRef } from 'react';
 import { ForwardRefExoticComponent } from 'react';
-import { InputProps } from '@copilotkit/react-ui';
 import { ItemProps } from './types';
 import { JSX as JSX_2 } from 'react';
 import { LocalAudioTrack } from 'livekit-client';
@@ -23,8 +23,10 @@ import { Props as Props_3 } from './types';
 import * as React_2 from 'react';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
+import { ReactPortal } from 'react';
 import { Ref } from 'react';
 import { RefAttributes } from 'react';
+import { RefObject } from 'react';
 import { RemoteAudioTrack } from 'livekit-client';
 import { SVGProps } from 'react';
 import * as SwitchPrimitive from '@radix-ui/react-switch';
@@ -46,7 +48,7 @@ export declare const actionItemStatuses: readonly ["inProgress", "executing", "c
 
 /* Excluded from this release type: AgentState */
 
-declare type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
+export declare type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
 
 /**
  * Credits configuration for the AI chat.
@@ -188,12 +190,6 @@ export declare type AiChatProviderProps = {
      * them here so canvas logic lives in one place.
      */
     canvasEntities?: Record<string, CanvasEntityDefinition>;
-    /**
-     * Available tool hints that the user can activate to provide intent context
-     * to the AI. Renders a selector button next to the send button.
-     * Only one tool hint can be active at a time.
-     */
-    toolHints?: AiChatToolHint[];
     /**
      * Credits configuration. When provided, a credits button is shown in the chat header.
      * Groups fetchUsage, upgradePlanUrl, and company/plan display info.
@@ -396,7 +392,7 @@ declare type AiChatProviderReturnValue = {
     pendingQuote: PendingQuote | null;
     /** Set the pending quote (pass null to clear). */
     setPendingQuote: React.Dispatch<React.SetStateAction<PendingQuote | null>>;
-} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "canvasActions" | "canvasEntities" | "toolHints" | "credits" | "employeeCredits" | "creditWarning" | "fileAttachments"> & {
+} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "canvasActions" | "canvasEntities" | "credits" | "employeeCredits" | "creditWarning" | "fileAttachments"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
     /** Open the canvas panel with the given content */
@@ -409,10 +405,6 @@ declare type AiChatProviderReturnValue = {
     openGame: (game: "pong") => void;
     /** Close the active mini-game overlay */
     closeGame: () => 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>>;
 };
 
 /**
@@ -434,7 +426,6 @@ declare interface AiChatState {
     entityRefs?: EntityRefs;
     canvasActions?: CanvasActions;
     canvasEntities?: Record<string, CanvasEntityDefinition>;
-    toolHints?: AiChatToolHint[];
     credits?: AiChatCredits;
     employeeCredits?: AiChatEmployeeCredits;
     creditWarning?: AiChatCreditWarning;
@@ -460,32 +451,10 @@ declare interface AiChatState {
     runtimeFetch?: typeof fetch;
 }
 
-/**
- * A tool hint that can be activated to prepend invisible context to the user's
- * message, telling the AI about the user's intent (e.g. "generate tables",
- * "data analysis"). Similar to Gemini's tool selector UI.
- *
- * Only one tool hint can be active at a time. It persists across messages
- * until the user explicitly removes it.
- */
-export declare type AiChatToolHint = {
-    /** Unique identifier for this tool hint */
-    id: string;
-    /** Display label shown in the selector and chip */
-    label: string;
-    /** Optional icon shown in the selector and chip */
-    icon?: IconType;
-    /**
-     * Prompt text injected as invisible context before the user's message.
-     * The AI receives this but the user never sees it in the chat.
-     */
-    prompt: string;
-};
-
 declare type AiChatTrackingOptions = {
     onVisibility?: () => void;
     onClose?: () => void;
-    onWelcomeSuggestionClick?: (suggestion: WelcomeScreenSuggestion) => void;
+    onWelcomeSuggestionClick?: (item: WelcomeScreenSuggestionItem) => void;
     onNewChat?: () => void;
     onMessage?: (message: Message) => void;
 };
@@ -533,6 +502,9 @@ export declare type AiInsightCardContent = {
     invertStatus?: boolean;
 };
 
+/** Assistant-flavoured `Message`. Same shape — alias for self-documentation. */
+declare type AIMessage_2 = Message_2;
+
 /**
  * Default AI chat translations — derived from the global defaultTranslations
  * to avoid manual duplication.
@@ -553,13 +525,6 @@ export declare const aiTranslations: {
         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 saveAsChanges: "Save as";
-        readonly exportTable: "Download table";
-        readonly generatedTableFilename: "OneGeneratedTable";
         readonly feedbackModal: {
             readonly positive: {
                 readonly title: "What did you like about this response?";
@@ -572,7 +537,6 @@ export declare const aiTranslations: {
                 readonly placeholder: "Share what didn’t work";
             };
         };
-        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";
@@ -590,7 +554,6 @@ export declare const aiTranslations: {
         readonly deleteChat: "Delete chat";
         readonly ask: "Ask One";
         readonly view: "View";
-        readonly tools: "Tools";
         readonly entityRef: {
             readonly candidate: {
                 readonly source: "Source";
@@ -612,42 +575,22 @@ export declare const aiTranslations: {
             readonly needMoreCredits: "Need more credits?";
         };
         readonly reportCard: {
-            readonly reportLabel: "Report";
             readonly tableLabel: "Table";
             readonly openButton: "Open";
         };
         readonly formCard: {
             readonly moreFields: "Open to see all fields";
         };
-        readonly dashboard: {
-            readonly save: "Save";
-            readonly saveToAnalytics: "Save the dashboard in Analytics";
-            readonly saveTableToAnalytics: "Save the table in Analytics";
-            readonly saveAs: "Save as";
-            readonly saveDialog: {
-                readonly title: "Save dashboard";
-                readonly titleLabel: "Title";
-                readonly descriptionLabel: "Description";
-                readonly descriptionPlaceholder: "Add a description (optional)";
-                readonly save: "Save";
-                readonly cancel: "Cancel";
-            };
-            readonly status: {
-                readonly saved: "Saved";
-                readonly draft: "Draft";
-                readonly unsaved: "Unsaved";
-            };
-            readonly statusLabel: "Status";
-            readonly lastEdited: "Last edited";
-            readonly createdBy: "Created by";
+        readonly aiTable: {
+            readonly title: "Table";
+            readonly downloadExcel: "Download Excel";
+            readonly downloadCsv: "Download CSV";
         };
         readonly dataDownload: {
             readonly title: "Download";
             readonly download: "Download {{format}}";
             readonly exportDashboard: "Export dashboard as {{format}}";
-            readonly export: "Export";
             readonly exporting: "Exporting…";
-            readonly rows: "{{amount}} rows";
         };
         readonly dashboardItem: {
             readonly chartType: "Chart type";
@@ -667,11 +610,6 @@ export declare const aiTranslations: {
             readonly soft: "You're running low on AI credits.";
             readonly getCredits: "Get credits";
             readonly dismiss: "Dismiss";
-            readonly messageBanner: {
-                readonly title: "This response requires credits";
-                readonly description: "Your company has run out of AI credits.";
-                readonly actionLabel: "Get credits";
-            };
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
@@ -757,6 +695,14 @@ export declare type AppendToolCall = {
     };
 };
 
+export declare type AttachedFile = {
+    id: string;
+    file: File;
+    status: "uploading" | "uploaded" | "error";
+    uploadedFile?: UploadedFile;
+    errorMessage?: string;
+};
+
 declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & {
     size?: (typeof internalAvatarSizes)[number];
     type?: (typeof internalAvatarTypes)[number];
@@ -903,36 +849,6 @@ export declare type CanvasActions = {
     dashboard?: DashboardCanvasActions;
 };
 
-/**
- * Shared inline card rendered in the AI chat for any canvas entity.
- * Shows a module avatar, title, description, and an Open/Close toggle button.
- * When active, displays a focus ring and the button switches to "Close".
- */
-export declare function CanvasCard({ module: cardModule, title, description, onOpen, showOpenButton, onClose, isActive, children, }: CanvasCardProps): JSX_2.Element;
-
-export declare namespace CanvasCard {
-    var displayName: string;
-}
-
-export declare type CanvasCardProps = {
-    /** Module avatar to display (e.g. "analytics", "surveys", "goals") */
-    module?: ModuleId;
-    /** Primary title */
-    title: string;
-    /** Secondary description line */
-    description: string;
-    /** Called when the user clicks the "Open" button */
-    onOpen: () => void;
-    /** Whether to show the "Open" button */
-    showOpenButton?: boolean;
-    /** Called when the user clicks the "Close" button (active state) */
-    onClose: () => void;
-    /** Whether this card's content is currently shown in the canvas */
-    isActive: boolean;
-    /** Optional content rendered below the card header (e.g. a data preview) */
-    children?: React.ReactNode;
-};
-
 /**
  * Discriminated union for canvas panel content.
  * Add new entity types to this union as they are implemented.
@@ -954,13 +870,7 @@ export declare type CanvasContentBase = {
  * Contract for a canvas entity type.
  *
  * Each entity (dashboard, survey, goal, job-posting…) implements this
- * interface and is added to the `canvasEntities` record in `registry.ts`.
- *
- * To add a new entity type:
- * 1. Create a folder in `canvas/entities/<your-entity>/`
- * 2. Define a type extending `CanvasContentBase` in `types.ts`
- * 3. Implement and export `CanvasEntityDefinition` in `index.tsx`
- * 4. Add the entity to the record in `canvas/registry.ts`
+ * interface and is added to the `canvasEntities` record passed to F0AiChat.
  */
 export declare type CanvasEntityDefinition<T extends CanvasContentBase = CanvasContentBase> = {
     /** Must match the `type` discriminant on the content object */
@@ -994,7 +904,7 @@ declare type CardInternalProps = F0AiInsightCardProps & {
     className?: string;
 };
 
-declare interface ChartComputation {
+export declare interface ChartComputation {
     datasetId: string;
     xAxis: string;
     yAxis: string;
@@ -1005,13 +915,13 @@ declare interface ChartComputation {
     limit?: number;
 }
 
-declare interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
+export declare interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
     type: "bar";
     orientation?: "vertical" | "horizontal";
     stacked?: boolean;
 }
 
-declare type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig;
+export declare type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig;
 
 declare interface ChatDashboardChartConfigBase {
     showLegend?: boolean;
@@ -1020,19 +930,19 @@ declare interface ChatDashboardChartConfigBase {
     valueFormat?: FormatPreset;
 }
 
-declare interface ChatDashboardChartItem extends ChatDashboardItemBase {
+export declare interface ChatDashboardChartItem extends ChatDashboardItemBase {
     type: "chart";
     chart: ChatDashboardChartConfig;
     computation: ChartComputation | RadarComputation | PieComputation | GaugeComputation | HeatmapComputation;
 }
 
-declare interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
+export declare interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
     type: "collection";
     columns: ChatDashboardColumn[];
     computation: CollectionComputation;
 }
 
-declare interface ChatDashboardColumn {
+export declare interface ChatDashboardColumn {
     /** Column key — must match a key in each row object */
     id: string;
     /** Display header label */
@@ -1077,16 +987,16 @@ export declare interface ChatDashboardConfig {
 }
 
 /** Granularity options exposed by F0's `OneDateNavigator`. */
-declare type ChatDashboardDateNavigationGranularity = "day" | "week" | "month" | "quarter" | "halfyear" | "year" | "range";
+export declare type ChatDashboardDateNavigationGranularity = "day" | "week" | "month" | "quarter" | "halfyear" | "year" | "range";
 
-declare interface ChatDashboardFilterDefinition {
+export declare interface ChatDashboardFilterDefinition {
     type: "in";
     label: string;
     column: string;
     datasetId: string;
 }
 
-declare interface ChatDashboardFunnelChartConfig {
+export declare interface ChatDashboardFunnelChartConfig {
     type: "funnel";
     sort?: "descending" | "ascending" | "none";
     orient?: "horizontal" | "vertical";
@@ -1097,7 +1007,7 @@ declare interface ChatDashboardFunnelChartConfig {
     valueFormat?: FormatPreset;
 }
 
-declare interface ChatDashboardGaugeChartConfig {
+export declare interface ChatDashboardGaugeChartConfig {
     type: "gauge";
     min?: number;
     max?: number;
@@ -1105,7 +1015,7 @@ declare interface ChatDashboardGaugeChartConfig {
     valueFormat?: FormatPreset;
 }
 
-declare interface ChatDashboardHeatmapChartConfig {
+export declare interface ChatDashboardHeatmapChartConfig {
     type: "heatmap";
     min?: number;
     max?: number;
@@ -1114,7 +1024,7 @@ declare interface ChatDashboardHeatmapChartConfig {
     valueFormat?: FormatPreset;
 }
 
-declare type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
+export declare type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
 
 declare interface ChatDashboardItemBase {
     id: string;
@@ -1153,14 +1063,14 @@ declare interface ChatDashboardItemBase {
     y?: number;
 }
 
-declare interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
+export declare interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
     type: "line";
     lineType?: "linear" | "smooth" | "step";
     showArea?: boolean;
     showDots?: boolean;
 }
 
-declare type ChatDashboardMetricFormat = {
+export declare type ChatDashboardMetricFormat = {
     type: "number";
 } | {
     type: "currency";
@@ -1173,7 +1083,7 @@ declare type ChatDashboardMetricFormat = {
     prefix?: string;
 };
 
-declare interface ChatDashboardMetricItem extends ChatDashboardItemBase {
+export declare interface ChatDashboardMetricItem extends ChatDashboardItemBase {
     type: "metric";
     format?: ChatDashboardMetricFormat;
     decimals?: number;
@@ -1187,7 +1097,7 @@ declare interface ChatDashboardMetricItem extends ChatDashboardItemBase {
  * grid. The `column` and `datasetId` are agent-side metadata used by the
  * compute SQL builder; they are stripped before reaching F0AnalyticsDashboard.
  */
-declare type ChatDashboardNavigationFilterDefinition = {
+export declare type ChatDashboardNavigationFilterDefinition = {
     type: "dateNavigation";
     label: string;
     column: string;
@@ -1196,7 +1106,7 @@ declare type ChatDashboardNavigationFilterDefinition = {
     defaultGranularity?: ChatDashboardDateNavigationGranularity;
 };
 
-declare interface ChatDashboardPieChartConfig {
+export declare interface ChatDashboardPieChartConfig {
     type: "pie";
     innerRadius?: number;
     showLegend?: boolean;
@@ -1205,22 +1115,24 @@ declare interface ChatDashboardPieChartConfig {
     valueFormat?: FormatPreset;
 }
 
-declare interface ChatDashboardRadarChartConfig extends ChatDashboardChartConfigBase {
+export declare interface ChatDashboardRadarChartConfig extends ChatDashboardChartConfigBase {
     type: "radar";
     showArea?: boolean;
 }
 
 export declare const ChatSpinner: ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & RefAttributes<SVGSVGElement>>;
 
-declare type ChatTextareaProps = InputProps & {
-    submitLabel?: string;
-    creditWarning?: AiChatCreditWarning;
+export declare type ChatThread = {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
 };
 
 /**
  * A single selectable option within a clarifying question step.
  */
-declare interface ClarifyingOption {
+export declare interface ClarifyingOption {
     /** Unique identifier for this option */
     id: string;
     /** Display label shown to the user */
@@ -1291,7 +1203,7 @@ export declare interface ClarifyingStepData {
  * A step enriched with the user's current interaction state.
  * Used internally by the controller to track selections per step.
  */
-declare interface ClarifyingStepState extends ClarifyingStepData {
+export declare interface ClarifyingStepState extends ClarifyingStepData {
     /** IDs of currently selected options */
     selectedOptionIds: string[];
     /** Current custom answer text (preserved even when deactivated) */
@@ -1300,11 +1212,7 @@ declare interface ClarifyingStepState extends ClarifyingStepData {
     isCustomAnswerActive: boolean;
 }
 
-export declare function CloseCanvasButton({ onClick }: {
-    onClick: () => void;
-}): JSX_2.Element;
-
-declare interface CollectionComputation {
+export declare interface CollectionComputation {
     datasetId: string;
     sortBy?: string;
     sortOrder?: "asc" | "desc";
@@ -1383,51 +1291,7 @@ export declare type DashboardCanvasContent = CanvasContentBase & {
     savedDashboardUnsaved?: boolean;
 };
 
-export declare function DashboardCanvasProvider({ content, children, }: {
-    content: DashboardCanvasContent;
-    children: ReactNode;
-}): ReactNode;
-
-/**
- * Dashboard-specific card that wraps CanvasCard with config-store
- * subscription logic. Re-renders when the user edits and saves
- * the dashboard layout.
- *
- * All saved-dashboard state (id, category, unsaved) is passed through
- * from the action arguments. The meta store overrides props after
- * save/create operations so close/re-open preserves the latest state.
- */
-export declare function DashboardCard({ config: originalConfig, apiConfig, savedDashboardId: propSavedId, savedDashboardCategory: propSavedCategory, savedDashboardDescription: propSavedDescription, savedDashboardUnsaved: propSavedUnsaved, }: DashboardCardProps): JSX_2.Element;
-
-export declare namespace DashboardCard {
-    var displayName: string;
-}
-
-export declare type DashboardCardProps = {
-    /** The original dashboard config from the agent */
-    config: ChatDashboardConfig;
-    /** API config for server-side dashboard computation */
-    apiConfig: {
-        baseUrl: string;
-        headers: Record<string, string>;
-        runtimeFetch?: typeof fetch;
-    };
-    /** Present when the dashboard is a pre-saved dashboard */
-    savedDashboardId?: string;
-    /** Category of the saved dashboard */
-    savedDashboardCategory?: string;
-    /** Description of the saved dashboard */
-    savedDashboardDescription?: string;
-    /** Whether the dashboard has unsaved changes */
-    savedDashboardUnsaved?: boolean;
-};
-
-export declare function DashboardContent({ content, refreshKey: _parentRefreshKey, }: {
-    content: DashboardCanvasContent;
-    refreshKey: number;
-}): ReactNode;
-
-declare interface DashboardFetchSpec {
+export declare interface DashboardFetchSpec {
     fetch: Array<{
         toolId: string;
         args: Record<string, unknown>;
@@ -1436,18 +1300,6 @@ declare interface DashboardFetchSpec {
     columnLabels?: Record<string, string>;
 }
 
-/**
- * Canvas header for the dashboard entity. Layout, title, status tag,
- * metadata strip, and the action row (export + close) are all delegated
- * to `ResourceHeader`. The close button is just another `secondaryAction`
- * with `hideLabel`, so the shared header component doesn't need to know
- * about canvas-specific close affordances.
- */
-export declare function DashboardHeader({ content, onClose, }: {
-    content: DashboardCanvasContent;
-    onClose: () => void;
-}): JSX_2.Element;
-
 /**
  * Creator + last-edited metadata for a saved dashboard. Returned by
  * `DashboardCanvasActions.getMetadata` so the header can render the author
@@ -1459,7 +1311,7 @@ export declare function DashboardHeader({ content, onClose, }: {
  * list page since this conversation was first opened). The header prefers
  * these values over the ones baked into `content` / `config`.
  */
-declare type DashboardMetadata = {
+export declare type DashboardMetadata = {
     /**
      * Latest persisted title. When present, the header displays this instead
      * of `content.title` so the chat-history snapshot never shadows the
@@ -1498,36 +1350,14 @@ export declare type DataDownloadCanvasContent = CanvasContentBase & {
     markdown?: string;
 };
 
-export declare function DataDownloadCard({ title: titleProp, dataset, filename, markdown, }: DataDownloadCardProps): JSX_2.Element;
-
-export declare namespace DataDownloadCard {
-    var displayName: string;
-}
-
-export declare type DataDownloadCardProps = {
-    title?: string;
-    dataset: DataDownloadDataset;
-    filename?: string;
-    markdown?: string;
-};
-
-export declare function DataDownloadContent({ content, }: {
-    content: DataDownloadCanvasContent;
-    refreshKey?: number;
-}): JSX_2.Element;
-
 /**
  * Inline dataset for client-side file generation (Excel / CSV).
  * Sent by the agent with the raw query results.
  */
 export declare type DataDownloadDataset = {
-    /**
-     * Column headers in display order.
-     */
+    /** Column headers in display order. */
     columns: string[];
-    /**
-     * Array of row objects keyed by column name.
-     */
+    /** Array of row objects keyed by column name. */
     rows: Record<string, unknown>[];
     /**
      * Total number of rows returned by the query (before truncation).
@@ -1546,16 +1376,6 @@ export declare type DataDownloadDataset = {
     columnLabels?: Record<string, string>;
 };
 
-export declare function DataDownloadHeader({ content, onClose, }: {
-    content: DataDownloadCanvasContent;
-    onClose: () => void;
-}): JSX_2.Element;
-
-export declare function DataDownloadProvider({ content, children, }: {
-    content: DataDownloadCanvasContent;
-    children: ReactNode;
-}): JSX_2.Element;
-
 declare const DataList: ForwardRefExoticComponent<DataListProps & RefAttributes<HTMLUListElement>> & {
     Item: ForwardRefExoticComponent<ItemProps & RefAttributes<HTMLLIElement>>;
     CompanyItem: ForwardRefExoticComponent<CompanyItemProps & RefAttributes<HTMLLIElement>>;
@@ -1577,6 +1397,8 @@ declare type DataListProps = {
     isHorizontal?: boolean;
 };
 
+export declare type DateGroup = "today" | "yesterday" | "thisMonth" | "older";
+
 export declare const defaultTranslations: {
     readonly countries: {
         ad: string;
@@ -1961,13 +1783,6 @@ 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 saveAsChanges: "Save as";
-        readonly exportTable: "Download table";
-        readonly generatedTableFilename: "OneGeneratedTable";
         readonly feedbackModal: {
             readonly positive: {
                 readonly title: "What did you like about this response?";
@@ -1980,7 +1795,6 @@ export declare const defaultTranslations: {
                 readonly placeholder: "Share what didn’t work";
             };
         };
-        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";
@@ -1998,7 +1812,6 @@ export declare const defaultTranslations: {
         readonly deleteChat: "Delete chat";
         readonly ask: "Ask One";
         readonly view: "View";
-        readonly tools: "Tools";
         readonly entityRef: {
             readonly candidate: {
                 readonly source: "Source";
@@ -2020,42 +1833,22 @@ export declare const defaultTranslations: {
             readonly needMoreCredits: "Need more credits?";
         };
         readonly reportCard: {
-            readonly reportLabel: "Report";
             readonly tableLabel: "Table";
             readonly openButton: "Open";
         };
         readonly formCard: {
             readonly moreFields: "Open to see all fields";
         };
-        readonly dashboard: {
-            readonly save: "Save";
-            readonly saveToAnalytics: "Save the dashboard in Analytics";
-            readonly saveTableToAnalytics: "Save the table in Analytics";
-            readonly saveAs: "Save as";
-            readonly saveDialog: {
-                readonly title: "Save dashboard";
-                readonly titleLabel: "Title";
-                readonly descriptionLabel: "Description";
-                readonly descriptionPlaceholder: "Add a description (optional)";
-                readonly save: "Save";
-                readonly cancel: "Cancel";
-            };
-            readonly status: {
-                readonly saved: "Saved";
-                readonly draft: "Draft";
-                readonly unsaved: "Unsaved";
-            };
-            readonly statusLabel: "Status";
-            readonly lastEdited: "Last edited";
-            readonly createdBy: "Created by";
+        readonly aiTable: {
+            readonly title: "Table";
+            readonly downloadExcel: "Download Excel";
+            readonly downloadCsv: "Download CSV";
         };
         readonly dataDownload: {
             readonly title: "Download";
             readonly download: "Download {{format}}";
             readonly exportDashboard: "Export dashboard as {{format}}";
-            readonly export: "Export";
             readonly exporting: "Exporting…";
-            readonly rows: "{{amount}} rows";
         };
         readonly dashboardItem: {
             readonly chartType: "Chart type";
@@ -2075,11 +1868,6 @@ export declare const defaultTranslations: {
             readonly soft: "You're running low on AI credits.";
             readonly getCredits: "Get credits";
             readonly dismiss: "Dismiss";
-            readonly messageBanner: {
-                readonly title: "This response requires credits";
-                readonly description: "Your company has run out of AI credits.";
-                readonly actionLabel: "Get credits";
-            };
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
@@ -2297,8 +2085,6 @@ export declare const defaultTranslations: {
         };
     };
     readonly forms: {
-        readonly yes: "Yes";
-        readonly no: "No";
         readonly actionBar: {
             readonly unsavedChanges: "You have changes pending to be saved";
             readonly saving: "Saving...";
@@ -2445,6 +2231,13 @@ declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> & {
  */
 declare type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 
+export declare const DropOverlay: ({ visible, onFilesDropped }: DropOverlayProps) => JSX_2.Element;
+
+declare interface DropOverlayProps {
+    visible: boolean;
+    onFilesDropped: (files: File[]) => void;
+}
+
 /**
  * Employee credits usage data returned by the host app.
  *
@@ -2522,7 +2315,7 @@ export declare interface F0ActionItemProps {
     /**
      * The title text displayed next to the status icon
      */
-    title: string;
+    title?: string;
     /**
      * Current status of the action item
      */
@@ -2539,16 +2332,192 @@ export declare interface F0ActionItemProps {
 export declare const F0AiChat: () => JSX_2.Element | null;
 
 /**
- * @experimental This is an experimental component use it at your own risk
+ * Headless chat header. Renders a top bar with title (or thread selector),
+ * credits popover, fullscreen toggle and close button. Has two visual
+ * variants:
+ * - with-history: title acts as a thread selector (clickable) — the host
+ *   wires `onOpenHistory` to mount its own history dialog.
+ * - legacy: title is static; a "new chat" button is shown when `hasMessages`.
+ *
+ * Decoupled from CopilotKit and `useAiChat()` — everything via props.
  */
-export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, canvasActions, canvasEntities, toolHints, credits, employeeCredits, creditWarning, fileAttachments, onThumbsUp, onThumbsDown, onBeforeSendMessage, runtimeFetch, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+export declare const F0AiChatHeader: ({ historyEnabled, title, currentThreadTitle, fullscreen, lockVisualizationMode, onToggleVisualizationMode, onClose, onNewChat, onOpenHistory, hasMessages, credits, employeeCredits, }: F0AiChatHeaderProps) => JSX_2.Element;
 
-export declare const F0AiChatTextArea: ({ submitLabel, inProgress, onSend, onStop, creditWarning, }: ChatTextareaProps) => JSX_2.Element;
+export declare type F0AiChatHeaderProps = {
+    /**
+     * When true, renders the with-history variant: the title acts as a thread
+     * selector that triggers `onOpenHistory`. When false (default), renders
+     * the legacy variant with `title` shown as a static heading.
+     */
+    historyEnabled?: boolean;
+    /** Static title for the legacy variant. Empty or undefined hides the heading. */
+    title?: string;
+    /**
+     * With-history variant: title of the currently loaded thread, or null for
+     * a brand-new conversation (renders the "New conversation" placeholder).
+     */
+    currentThreadTitle?: string | null;
+    /** Whether the chat is currently in fullscreen mode (controls expand/minimize icon). */
+    fullscreen?: boolean;
+    /** When true, hides the expand/minimize button and the history selector. */
+    lockVisualizationMode?: boolean;
+    /** Toggle fullscreen ↔ sidepanel. */
+    onToggleVisualizationMode?: () => void;
+    /** Close button (X) callback. */
+    onClose: () => void;
+    /**
+     * Legacy variant only: callback for the "new chat" button. Hidden when
+     * `hasMessages` is false (i.e. the thread is empty so a new chat would be
+     * a no-op).
+     */
+    onNewChat?: () => void;
+    /** With-history variant: callback fired when the user clicks the title. */
+    onOpenHistory?: () => void;
+    /** Legacy variant gate: only renders the "new chat" button when true. */
+    hasMessages?: boolean;
+    /** Credits configuration. When present, renders the credits popover button. */
+    credits?: AiChatCredits;
+    /**
+     * Employee-level credits configuration. When present, an employee-only
+     * popover is rendered **instead of** the classic one (mutually exclusive
+     * with `credits`). Hosts opt in per-employee.
+     */
+    employeeCredits?: AiChatEmployeeCredits;
+};
+
+/**
+ * Headless chat-history dialog. Receives threads + handlers via props so
+ * it can be wired against any backend or mocked in stories. No CopilotKit
+ * or `useAiChat()` dependency.
+ */
+export declare const F0AiChatHistory: ({ onClose, onSelectThread, onNewChat, threads, isLoading, error, pinnedIds, onPinThread, onUnpinThread, onDeleteThread, }: F0AiChatHistoryProps) => ReactPortal;
+
+export declare type F0AiChatHistoryProps = {
+    /** Close the dialog (overlay click, ESC, or post-selection). */
+    onClose: () => void;
+    /** Called when the user picks a thread to load. */
+    onSelectThread: (threadId: string, title: string) => void;
+    /** Called when the user clicks "Start new chat". */
+    onNewChat: () => void;
+    /** Thread list (already fetched). */
+    threads: ChatThread[];
+    /** Whether the threads are still being fetched. */
+    isLoading: boolean;
+    /** Fetch error message, or null when no error. */
+    error: string | null;
+    /** Set of pinned thread IDs. */
+    pinnedIds: Set<string>;
+    /** Called when the user pins a thread. */
+    onPinThread: (id: string) => void;
+    /** Called when the user unpins a thread. */
+    onUnpinThread: (id: string) => void;
+    /** Called when the user deletes a thread (may be async). */
+    onDeleteThread: (id: string) => Promise<void> | void;
+};
 
 /**
  * @experimental This is an experimental component use it at your own risk
  */
-export declare const F0AiFullscreenChat: () => JSX_2.Element | null;
+export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, canvasActions, canvasEntities, credits, employeeCredits, creditWarning, fileAttachments, onThumbsUp, onThumbsDown, onBeforeSendMessage, runtimeFetch, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+
+/**
+ * Headless chat composer.
+ *
+ * Owns local UI state (text, cursor, attached files, mention popover) and
+ * emits a structured payload via `onSubmit`. The consumer decides what to
+ * do with it (forward to CopilotKit, log it, mock it…). It carries no
+ * coupling to `useAiChat()` or CopilotKit — wrappers like F0AiChat
+ * provide the wiring.
+ */
+export declare const F0AiChatTextArea: ({ onSubmit, onStop, inProgress, onBeforeSubmit, placeholders, creditWarning, clarifyingQuestion, pendingContext, onPendingContextChange, pendingQuote, onPendingQuoteChange, fileAttachments, searchPersons, onProcessFilesRef, disclaimer, footer, isWelcomeScreen, fullscreen, welcomeScreenSuggestions, onSuggestionClick, ref, }: F0AiChatTextAreaProps) => JSX_2.Element;
+
+export declare type F0AiChatTextAreaProps = {
+    ref: RefObject<HTMLDivElement>;
+    /** Emitted when the user submits. Awaited so the textarea can stay disabled. */
+    onSubmit: (payload: F0AiChatTextAreaSubmitPayload) => void | Promise<void>;
+    /** Called when the user clicks the stop button while a response is streaming. */
+    onStop?: () => void;
+    /** Whether a response is currently streaming. Switches the submit button to "stop". */
+    inProgress?: boolean;
+    /**
+     * Optional gate run before submission. Return `false` to abort the send
+     * (e.g. show a quota dialog). The textarea stays focused and the input
+     * is preserved.
+     */
+    onBeforeSubmit?: () => boolean | Promise<boolean>;
+    /** Rotating placeholders for the typewriter effect. Empty/single-entry skips the typewriter. */
+    placeholders?: string[];
+    /** Credit warning banner shown above the composer. */
+    creditWarning?: AiChatCreditWarning;
+    /**
+     * Clarifying question to render in place of the input. When non-null the
+     * panel takes over the composer surface and submission is blocked.
+     */
+    clarifyingQuestion?: ClarifyingQuestionState | null;
+    /** Pending context shown as a chip; prepended invisibly on submit. */
+    pendingContext?: PendingContext | null;
+    /** Called when the user dismisses pending context (or it gets consumed on submit). */
+    onPendingContextChange?: (context: PendingContext | null) => void;
+    /** Pending quote shown as a chip above the textarea. */
+    pendingQuote?: PendingQuote | null;
+    /** Called when the user dismisses the quote (or it gets consumed on submit). */
+    onPendingQuoteChange?: (quote: PendingQuote | null) => void;
+    /** File attachment configuration. When omitted, attachments are disabled. */
+    fileAttachments?: AiChatFileAttachmentConfig;
+    /** Async search used by the @-mention popover. When omitted, mentions are disabled. */
+    searchPersons?: (query: string) => Promise<PersonProfile[]>;
+    /**
+     * Registers a callback that lets external drop zones forward dropped
+     * files to this textarea's file-attachment pipeline. The textarea calls
+     * the registrar with the handler on mount and with `null` on unmount.
+     */
+    onProcessFilesRef?: (handler: ((files: File[]) => void) | null) => void;
+    /**
+     * Optional disclaimer text + link rendered below the textarea. Hidden on
+     * the welcome screen of the fullscreen layout to give the footer room.
+     */
+    disclaimer?: AiChatDisclaimer;
+    /**
+     * Optional footer (e.g. powered-by, legal copy) rendered below the
+     * textarea on the welcome screen.
+     */
+    footer?: ReactNode;
+    /**
+     * Whether the chat is currently in its welcome state (no messages yet).
+     * Controls footer visibility and welcome-screen-only layout tweaks.
+     */
+    isWelcomeScreen?: boolean;
+    /**
+     * Grouped suggestions rendered as outline buttons above the composer on
+     * the welcome screen. Clicking a group opens a single popover (above the
+     * row, left-aligned, spanning the composer width) with that group's items.
+     * Hovering an item previews its prompt in the textarea placeholder.
+     */
+    welcomeScreenSuggestions?: WelcomeScreenSuggestion[];
+    /** Called when the user clicks a sub-suggestion. */
+    onSuggestionClick?: (item: WelcomeScreenSuggestionItem) => void;
+    /**
+     * When true, the composer adopts the fullscreen layout: the welcome
+     * footer is pushed to the bottom and the disclaimer is hidden so the
+     * footer is the only thing under the textarea.
+     */
+    fullscreen?: boolean;
+};
+
+/**
+ * Payload emitted by `F0AiChatTextArea` when the user submits.
+ *
+ * `text` already contains the inline markup the renderer expects:
+ * `<entity-ref>` tags for @mentions, `<reply-quote>` for the quoted
+ * fragment, and HTML-escaped user-typed text. The consumer decides how
+ * to wrap it (plain string vs multipart message) when forwarding to
+ * the agent.
+ */
+export declare type F0AiChatTextAreaSubmitPayload = {
+    text: string;
+    files: UploadedFile[];
+    context: PendingContext | null;
+};
 
 export declare const F0AiInsightCard: WithDataTestIdReturnType<ForwardRefExoticComponent<F0AiInsightCardPublicProps & RefAttributes<HTMLDivElement>> & {
 Skeleton: () => JSX_2.Element;
@@ -2594,6 +2563,92 @@ export declare class F0AiMask {
     private render;
 }
 
+export declare const F0AiMessagesContainer: (props: F0AiMessagesContainerProps) => JSX_2.Element;
+
+export declare type F0AiMessagesContainerProps = {
+    /** Optional override for the assistant bubble component. */
+    AssistantMessage?: MessageSlotComponent;
+    /** Optional override for the user bubble component. */
+    UserMessage?: MessageSlotComponent;
+    /** Called when the user triggers regeneration on an assistant message. */
+    onRegenerate?: (messageId: string) => void;
+    /** Called when the user copies an assistant message's content. */
+    onCopy?: (content: string) => void;
+    /** Pre-processed turns to render (assembled by the connected wrapper). */
+    turns: RenderableTurn[];
+    /** Show a skeleton in place of the turns while a thread is being fetched. */
+    isLoadingThread?: boolean;
+    /** Optional React node rendered inline at the end of the list (e.g. CopilotKit interrupt). */
+    interrupt?: ReactNode;
+    /** Greeting shown above the initial message in the welcome screen. */
+    greeting?: string;
+    /** Initial message(s) shown in the welcome screen, or a default if omitted. */
+    initialMessage?: string | string[];
+    /** Optional click on the One icon (factorial uses it for the pong easter egg). */
+    onWelcomeIconClick?: () => void;
+    /** Returns a React node for an assistant message's tool call, or null. */
+    renderToolCall?: F0AssistantMessageExtraProps["renderToolCall"];
+    /** Called when the user selects text and clicks Reply (user or assistant bubble). */
+    onReplyQuote?: (text: string) => void;
+    /** Called when an assistant message finishes generating — for analytics. */
+    onAssistantMessageRendered?: (message: Message_2) => void;
+    /** Disables auto-scrollIntoView on new user messages (fullscreen sets false). */
+    autoScrollUserIntoView?: boolean;
+    /**
+     * Renders the markdown content of user/assistant messages. The connected
+     * wrapper provides a CopilotKit + f0-markdown-renderers implementation;
+     * standalone consumers can omit it and a plain whitespace-preserving
+     * fallback is used.
+     */
+    renderMarkdown?: (content: string) => ReactNode;
+    /** When omitted, feedback (thumbs + modal) is hidden. */
+    feedback?: FeedbackConfig;
+    /** Pause turnMinHeight observer (e.g. while a clarifying panel is open). */
+    freezeLayout?: boolean;
+    /** Disable the top/bottom scroll shadows. */
+    noShadows?: boolean;
+    /** Passthrough children appended after the last turn (CopilotKit parity). */
+    children?: ReactNode;
+};
+
+/**
+ * Information source attached to an assistant message.
+ */
+export declare type F0AiMessageSource = {
+    title: string;
+    link?: string;
+    /** Name of an icon exported by `@factorialco/f0-react/icons/app`. */
+    icon?: string;
+    targetBlank?: boolean;
+};
+
+/**
+ * Renders a collapsible group of information sources attached to an
+ * assistant message. Sources without a `link` render as plain rows;
+ * sources with a `link` render as clickable Actions. Pure presentational
+ * — no hooks, no AI coupling.
+ */
+export declare function F0AiMessageSources({ sources, title: titleProp, }: F0AiMessageSourcesProps): JSX_2.Element | null;
+
+export declare namespace F0AiMessageSources {
+    var displayName: string;
+}
+
+export declare type F0AiMessageSourcesProps = {
+    sources: F0AiMessageSource[];
+    /**
+     * Override the section title. Defaults to the
+     * `ai.resourcesGroupTitle` translation key.
+     */
+    title?: string;
+};
+
+export declare const F0AiPong: ({ onClose }: F0AiPongProps) => JSX_2.Element;
+
+declare interface F0AiPongProps {
+    onClose: () => void;
+}
+
 export declare function F0AiProposalCard(props: F0AiProposalCardProps): JSX_2.Element;
 
 export declare namespace F0AiProposalCard {
@@ -2635,6 +2690,57 @@ export declare interface F0AiProposalCardHiddenActions {
 
 export declare type F0AiProposalCardProps = F0AiProposalCardBaseProps & (F0AiProposalCardActions | F0AiProposalCardHiddenActions);
 
+/**
+ * Compact inline table for small datasets shown directly in an AI chat
+ * stream. Headers come from `columnLabels` when present, otherwise from
+ * the raw column id. Shows a download dropdown (Excel / CSV) — Excel
+ * support is loaded lazily via `xlsx`. Pure presentational — no hooks,
+ * no AI coupling.
+ */
+export declare function F0AiTableCard({ dataset, title: titleProp, filename, }: F0AiTableCardProps): JSX_2.Element | null;
+
+export declare namespace F0AiTableCard {
+    var displayName: string;
+}
+
+export declare type F0AiTableCardProps = {
+    /**
+     * Tabular data to render. Reuses the same shape used by the
+     * `dataDownload` canvas entity so the agent payload travels untouched.
+     */
+    dataset: DataDownloadDataset;
+    /**
+     * Title shown above the table. Defaults to the `ai.aiTable.title`
+     * translation key (English: "Table").
+     */
+    title?: string;
+    /**
+     * Filename used for downloads (without extension). Defaults to the
+     * slugified title, or `"table"` when no title is provided.
+     */
+    filename?: string;
+};
+
+declare type F0AssistantMessageExtraProps = {
+    /**
+     * Returns a React node for the message's tool call, or null when there is
+     * nothing to render. The container's connected wrapper closes over the
+     * full message list to call CopilotKit's lazy tool renderer; standalone
+     * consumers can omit it.
+     */
+    renderToolCall?: (message: Message_2) => ReactNode | null;
+    /** Called when the user selects text in this message and clicks Reply. */
+    onReplyQuote?: (text: string) => void;
+    /** Called once the assistant message has finished generating — for analytics. */
+    onRendered?: (message: Message_2) => void;
+    /**
+     * Renders the assistant text content. The connected wrapper provides a
+     * markdown-aware implementation; standalone consumers can omit it and a
+     * plain whitespace-preserving fallback is used instead.
+     */
+    renderMarkdown?: (content: string) => ReactNode;
+};
+
 export declare function F0AuraVoiceAnimation({ size, state, color, colorShift, audioTrack, themeMode, className, ref, ...props }: F0AuraVoiceAnimationProps & ComponentProps<"div"> & VariantProps<typeof F0AuraVoiceAnimationVariants>): JSX_2.Element;
 
 export declare interface F0AuraVoiceAnimationProps {
@@ -2779,6 +2885,80 @@ declare type F0AvatarTeamProps = {
     badge?: AvatarBadge;
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
 
+/**
+ * Shared inline card rendered in the AI chat for any canvas entity.
+ * Shows a module avatar, title, description, and an Open/Close toggle button.
+ * When active, displays a focus ring and the button switches to "Close".
+ */
+export declare function F0CanvasCard({ module: cardModule, title, description, onOpen, showOpenButton, onClose, isActive, children, }: F0CanvasCardProps): JSX_2.Element;
+
+export declare namespace F0CanvasCard {
+    var displayName: string;
+}
+
+export declare type F0CanvasCardProps = {
+    /** Module avatar to display (e.g. "analytics", "surveys", "goals") */
+    module?: ModuleId;
+    /** Primary title */
+    title: string;
+    /** Secondary description line */
+    description: string;
+    /** Called when the user clicks the "Open" button */
+    onOpen: () => void;
+    /** Whether to show the "Open" button */
+    showOpenButton?: boolean;
+    /** Called when the user clicks the "Close" button (active state) */
+    onClose: () => void;
+    /** Whether this card's content is currently shown in the canvas */
+    isActive: boolean;
+    /** Optional content rendered below the card header (e.g. a data preview) */
+    children?: React.ReactNode;
+};
+
+/**
+ * Entity-agnostic canvas panel that renders content alongside the chat sidebar.
+ *
+ * Looks up the entity definition from the `entities` prop using
+ * `content.type` and delegates rendering of body and header actions to the
+ * entity module. The panel shell handles animation, body scroll area, and
+ * refreshKey bookkeeping (auto-increments when `content` changes by identity).
+ *
+ * Headless: no CopilotKit or `useAiChat()` dependency — the host wires
+ * `content`, `onClose` and `entities` directly.
+ */
+export declare function F0CanvasPanel({ content, onClose, entities, }: F0CanvasPanelProps): ReactNode;
+
+export declare namespace F0CanvasPanel {
+    var displayName: string;
+}
+
+export declare type F0CanvasPanelProps = {
+    /** Current canvas content to render. When null, the panel collapses. */
+    content: CanvasContent | null;
+    /** Called when the user closes the canvas. */
+    onClose: () => void;
+    /** Canvas entity registry keyed by `CanvasContent["type"]`. */
+    entities?: Record<string, CanvasEntityDefinition<any>>;
+};
+
+/**
+ * Animated wrapper that mounts/unmounts the clarifying question panel.
+ *
+ * Uses Motion's native `height: "auto"` support — it measures the
+ * content internally, so the same transition covers the initial
+ * appearance, step changes with a different number of options, and
+ * dismissal. No manual ResizeObserver.
+ *
+ * Props-driven: the entire panel state (current step, navigation,
+ * callbacks) lives in `clarifyingQuestion`. No coupling to `useAiChat`
+ * — embedders can construct a state object themselves.
+ */
+export declare const F0ClarifyingPanel: ({ clarifyingQuestion, }: F0ClarifyingPanelProps) => JSX_2.Element;
+
+declare interface F0ClarifyingPanelProps {
+    clarifyingQuestion: ClarifyingQuestionState;
+}
+
 export declare const F0HILActionConfirmation: ({ text, confirmationText, onConfirm, cancelText, onCancel, }: F0HILActionConfirmationProps) => JSX_2.Element;
 
 /**
@@ -2814,25 +2994,6 @@ declare interface F0IconProps extends SVGProps<SVGSVGElement>, VariantProps<type
     color?: "default" | "currentColor" | `#${string}` | Lowercase<NestedKeyOf<typeof f1Colors.icon>>;
 }
 
-export declare const F0MessageCreditsWarning: ({ actionHref, }: F0MessageCreditsWarningProps) => JSX_2.Element;
-
-/**
- * Args for credits warning copilot action
- */
-export declare interface F0MessageCreditsWarningArgs {
-    actionHref?: string;
-}
-
-/**
- * Props for the F0MessageCreditsWarning component
- */
-export declare interface F0MessageCreditsWarningProps {
-    /**
-     * Optional URL used by the action button.
-     */
-    actionHref?: string;
-}
-
 export declare const F0OneIcon: ForwardRefExoticComponent<Omit<F0OneIconProps, "ref"> & RefAttributes<SVGSVGElement>>;
 
 /**
@@ -2967,10 +3128,16 @@ declare interface F0TagStatusProps {
 
 declare const F0TagTeam: WithDataTestIdReturnType<ForwardRefExoticComponent<F0TagTeamProps & RefAttributes<HTMLDivElement>>>;
 
-declare type FieldMeta = {
-    label: string;
-    fieldType?: string;
-    customFieldName?: string;
+export declare type FeedbackConfig = {
+    threadId: string;
+    onThumbsUp: (msg: AIMessage_2, ctx: {
+        threadId: string;
+        feedback: string;
+    }) => void;
+    onThumbsDown: (msg: AIMessage_2, ctx: {
+        threadId: string;
+        feedback: string;
+    }) => void;
 };
 
 declare type FileAvatarVariant = Extract<AvatarVariant, {
@@ -2991,7 +3158,7 @@ declare type FlagAvatarVariant = Extract<AvatarVariant, {
  * real formatter function. The wrapper component maps these to actual
  * `(value: number) => string` functions at render time.
  */
-declare type FormatPreset = {
+export declare type FormatPreset = {
     type: "number";
 } | {
     type: "currency";
@@ -3012,45 +3179,6 @@ export declare type FormCanvasContent = CanvasContentBase & {
     formModule?: ModuleId;
 };
 
-/**
- * Form-specific card rendered inline in the AI chat stream.
- * Shows the active form name, description, and an Open/Close button
- * that opens the form in the canvas panel.
- * When field data is provided, displays a summary of field labels and values.
- */
-export declare function FormCard({ formName, formDescription, module: formModule, cardTitle, cardDescription, fieldDescriptions, formValues, valueFormatter, }: FormCardProps): JSX_2.Element;
-
-export declare namespace FormCard {
-    var displayName: string;
-}
-
-export declare type FormCardProps = {
-    /** Unique name of the form in the registry */
-    formName: string;
-    /** Optional description shown on the card */
-    formDescription?: string;
-    /** Module avatar for the card */
-    module?: ModuleId;
-    /** Custom title override for the card (set by the AI via fillForm) */
-    cardTitle: string;
-    /** Custom description override for the card (set by the AI via fillForm) */
-    cardDescription: string;
-    /** Field label metadata from the form schema */
-    fieldDescriptions?: Record<string, FieldMeta>;
-    /** Current form values */
-    formValues?: Record<string, unknown>;
-    /**
-     * Optional callback to format a field value into a DetailsItemContent.
-     * Return `undefined` to fall back to built-in formatting.
-     */
-    valueFormatter?: FormCardValueFormatter;
-};
-
-declare type FormCardValueFormatter = (key: string, value: unknown, meta: {
-    fieldType?: string;
-    customFieldName?: string;
-}) => DetailsItemContent | DetailsItemContent[] | undefined;
-
 export declare interface FormCardValueFormatterEntry<T = unknown> {
     /** Scope to a specific form. Omit to apply to all forms. */
     formName?: string;
@@ -3068,25 +3196,7 @@ export declare function FormCardValueFormatterProvider({ children, }: {
     children: ReactNode;
 }): JSX_2.Element;
 
-/**
- * Canvas panel content for forms.
- * Propless — reads the active form from coagent shared state
- * and delegates to VirtualFormContent for rendering.
- */
-export declare function FormContent(): ReactNode;
-
-export declare namespace FormContent {
-    var displayName: string;
-}
-
-export declare function FormHeader({ title, description, module, onClose, }: {
-    title: string;
-    description?: string;
-    module?: ModuleId;
-    onClose: () => void;
-}): JSX_2.Element;
-
-declare interface GaugeComputation {
+export declare interface GaugeComputation {
     datasetId: string;
     aggregation: AggregationType;
     column?: string;
@@ -3095,7 +3205,7 @@ declare interface GaugeComputation {
     name?: string;
 }
 
-declare interface HeatmapComputation {
+export declare interface HeatmapComputation {
     datasetId: string;
     xAxis: string;
     yAxis: string;
@@ -3160,16 +3270,6 @@ declare type Level = (typeof levels)[number];
 
 declare const levels: readonly ["info", "warning", "critical", "positive"];
 
-/**
- * External store for saved (user-edited) dashboard configs.
- *
- * This lives outside React's component tree so that `F0ChatReportCard`
- * (rendered inside CopilotKit's message list) can subscribe to changes
- * via `useSyncExternalStore` — which works regardless of whether the
- * React context provider is an ancestor.
- */
-declare type Listener = () => void;
-
 export declare type MaskOptions = {
     /**
      * The width of the Mask element.
@@ -3226,19 +3326,35 @@ export declare type MaskOptions = {
     styles?: Partial<CSSStyleDeclaration>;
 };
 
-export declare const MessageSources: ({ sources }: MessageSourcesProps) => JSX_2.Element | null;
-
 /**
- * Props for the F0MessageSources component
+ * Loose message shape used by the headless container and its
+ * subcomponents. Mirrors the CopilotKit `Message`/`AIMessage` shape
+ * (which the bridge builds upstream) but is owned by f0 so the
+ * headless boundary doesn't import from `@copilotkit/shared`.
+ *
+ * Most fields are optional / wide on purpose — the headless renders
+ * what it finds and ignores the rest.
  */
-export declare type MessageSourcesProps = {
-    /**
-     * Array of sources to display
-     */
-    sources: Source[];
+declare type Message_2 = {
+    id?: string;
+    role?: string;
+    content?: unknown;
+    toolCalls?: Array<{
+        id: string;
+        type?: string;
+        function?: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    generativeUI?: () => unknown;
+    rawData?: unknown;
+    [key: string]: any;
 };
 
-declare interface MetricComputation {
+declare type MessageSlotComponent = ComponentType<any>;
+
+export declare interface MetricComputation {
     datasetId: string;
     aggregation: AggregationType;
     column?: string;
@@ -3453,10 +3569,6 @@ export declare type OneIconSize = (typeof oneIconSizes)[number];
 
 export declare const oneIconSizes: readonly ["xs", "sm", "md", "lg"];
 
-export declare type OrchestratorThinkingResult = {
-    inGroup?: boolean;
-};
-
 declare type PathsToStringProps<T> = T extends string ? [] : {
     [K in Extract<keyof T, string>]: [K, ...PathsToStringProps<T[K]>];
 }[Extract<keyof T, string>];
@@ -3503,7 +3615,7 @@ export declare type PersonProfile = {
 
 declare type PersonTagProps = ComponentProps<typeof F0TagPerson>;
 
-declare interface PieComputation {
+export declare interface PieComputation {
     datasetId: string;
     nameColumn: string;
     valueColumn: string;
@@ -3513,6 +3625,14 @@ declare interface PieComputation {
     limit?: number;
 }
 
+export declare function PongBall({ size, className, style }: PongBallProps): JSX_2.Element;
+
+declare interface PongBallProps {
+    size?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+
 declare const privateProps: readonly ["className"];
 
 declare type Props<Text extends string = string> = {
@@ -3536,7 +3656,7 @@ declare type Props_2 = {
     customColor: string;
 });
 
-declare interface RadarComputation {
+export declare interface RadarComputation {
     datasetId: string;
     seriesColumn: string;
     indicators: Array<{
@@ -3557,6 +3677,62 @@ declare type RelaxedNumericWithFormatter = Omit<NumericWithFormatter, "numericVa
     numericValue: Numeric;
 };
 
+/**
+ * Pre-processed turn ready to render. The bridge (F0AiChat/Connected*)
+ * assembles these by filtering CopilotKit bookkeeping, expanding AG-UI
+ * tool-call messages, and analysing role/stream state. The headless
+ * container iterates them as-is — no message-shape inspection.
+ *
+ * A turn renders as: leading user messages → optional Thinking section →
+ * assistant messages → optional inline live-thinking message → optional
+ * end-of-turn indicator → optional feedback footer.
+ */
+export declare type RenderableTurn = {
+    /** Messages rendered before the thinking section (typically the user message). */
+    userMessages: Message_2[];
+    /**
+     * Optional collapsible "thinking" header rendered between user and
+     * assistant blocks. Titles are pre-parsed upstream.
+     */
+    thinking?: {
+        titles: string[];
+        /**
+         * Whether this turn is still streaming. The collapsible stays locked
+         * open while true (no chevron, no toggle) and auto-collapses on the
+         * transition to false.
+         */
+        inProgress?: boolean;
+        /**
+         * Whether the agent already moved from reflecting to writing the
+         * response. When true every item renders as `completed`; otherwise
+         * the last item is `executing` while the rest are `completed`.
+         */
+        isWriting?: boolean;
+    };
+    /** Messages rendered after the thinking section (assistant replies). */
+    assistantMessages: Message_2[];
+    /** True while the agent is still producing content for this turn. */
+    isInProgress: boolean;
+    /**
+     * Optional end-of-turn indicator:
+     * - `"thinking"`: agent is running but hasn't emitted any assistant output
+     *   yet (renders an action item titled "Thinking...").
+     * - `"activity"`: agent is streaming with some assistant output already
+     *   visible (renders an empty action item).
+     */
+    endIndicator?: "thinking" | "activity";
+    /**
+     * Optional feedback footer (thumbs + copy button). When omitted, the
+     * turn renders without feedback affordances.
+     */
+    feedback?: {
+        /** Concatenated assistant content for the copy button. */
+        content: string;
+        /** Reference message attached to feedback submissions. */
+        targetMessage: Message_2;
+    };
+};
+
 export declare type RequisitionProfile = {
     id: string | number;
     title: string;
@@ -3592,37 +3768,8 @@ export declare interface ResolvedStepAnswer {
     cancelled?: boolean;
 }
 
-export declare const savedDashboardConfigStore: {
-    get(toolCallId: string): ChatDashboardConfig | undefined;
-    set(toolCallId: string, config: ChatDashboardConfig): void;
-    subscribe(listener: Listener): () => void;
-    getSnapshot(): number;
-};
-
 declare type SetFormCardValueFormatter = <T = unknown>(entry: FormCardValueFormatterEntry<T>) => void;
 
-/**
- * Source object for message sources
- */
-export declare type Source = {
-    /**
-     * Title of the source
-     */
-    title: string;
-    /**
-     * Optional link URL
-     */
-    link?: string;
-    /**
-     * Optional icon name (from @/icons/app)
-     */
-    icon?: string;
-    /**
-     * Whether to open link in new tab
-     */
-    targetBlank?: boolean;
-};
-
 export declare type SparklineDataPoint = {
     value: number;
 };
@@ -3676,6 +3823,37 @@ declare type TeamAvatarVariant = Extract<AvatarVariant, {
 
 declare type TeamTagProps = ComponentProps<typeof F0TagTeam>;
 
+/** Props for the Thinking collapsible section. */
+export declare type ThinkingProps = {
+    /** Pre-parsed step titles to show inside the collapsed group. */
+    titles: string[];
+    /** Section heading (defaults to "Thoughts" from i18n). */
+    title?: string;
+    /**
+     * Whether the turn is still streaming. Locks the collapsible open (no
+     * chevron, no user toggle) while true and auto-collapses on the
+     * transition to false. After that, the user can toggle freely.
+     */
+    inProgress?: boolean;
+    /**
+     * Whether the agent already started writing the response. When true,
+     * every item renders as `completed` regardless of `inProgress`.
+     */
+    isWriting?: boolean;
+};
+
+export declare interface ThreadActionHandlers {
+    onSelect: (threadId: string, title: string) => void;
+    onPin: (id: string) => void;
+    onUnpin: (id: string) => void;
+    onDelete: (id: string) => void;
+}
+
+export declare interface ThreadGroup {
+    key: DateGroup;
+    threads: ChatThread[];
+}
+
 declare type TranslationKey = Join<PathsToStringProps<typeof defaultTranslations>, ".">;
 
 declare type TranslationShape<T> = {
@@ -3700,6 +3878,15 @@ export declare type UploadedFile = {
     mimetype: string;
 };
 
+/**
+ * Read the AiChat context. Returns an inert fallback when no provider
+ * is mounted — that case is intentional in `ApplicationFrame`, which
+ * renders chat-aware components in both the AI-enabled tree and the
+ * promotion-chat tree.
+ *
+ * Most consumers don't need to think about this — they're rendered
+ * under `<F0AiChatProvider>` and receive the real context.
+ */
 export declare function useAiChat(): AiChatProviderReturnValue;
 
 export declare function useAiChatTranslations(): AiChatTranslations;
@@ -3711,6 +3898,40 @@ export declare function useAiChatTranslations(): AiChatTranslations;
  */
 export declare function useCanvasEntity(type: string | undefined): CanvasEntityDefinition<any> | undefined;
 
+/**
+ * Headless chat-history state manager. Pure UI logic — the caller injects
+ * `fetchThreads` and `deleteThread` callbacks so this hook never embeds
+ * URLs, auth headers or fetch wiring. Manages pinned threads in
+ * localStorage and the threads list (loading/error/data).
+ */
+export declare function useChatHistory({ enabled, fetchThreads: fetchThreadsCb, deleteThread: deleteThreadCb, }: UseChatHistoryOptions): UseChatHistoryReturn;
+
+declare type UseChatHistoryOptions = {
+    /** When true, fetches threads on mount. Default: `false`. */
+    enabled?: boolean;
+    /**
+     * Async callback that returns the list of threads. The host owns the
+     * URL/auth/fetch — this hook only calls the callback and manages state.
+     */
+    fetchThreads: () => Promise<ChatThread[]>;
+    /**
+     * Async callback that deletes a thread by id. Should throw or reject on
+     * failure; the hook will then re-fetch to restore consistency.
+     */
+    deleteThread: (id: string) => Promise<void>;
+};
+
+declare type UseChatHistoryReturn = {
+    threads: ChatThread[];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+    pinnedIds: Set<string>;
+    pinThread: (id: string) => void;
+    unpinThread: (id: string) => void;
+    deleteThread: (id: string) => Promise<void>;
+};
+
 /**
  * Returns a resolved formatter for the given `formName`.
  * Matches registered formatters by specificity:
@@ -3726,6 +3947,20 @@ export declare function useI18n(): TranslationsType & {
     t: (key: TranslationKey, args?: Record<string, string | number>) => string;
 };
 
+export declare type UserBinaryPart = {
+    type: "binary";
+    url: string;
+    filename: string;
+    mimeType: string;
+};
+
+export declare type UserReaction = "like" | "dislike";
+
+export declare type UserTextPart = {
+    type: "text";
+    text: string;
+};
+
 /**
  * Returns a setter to register value formatters used by FormCard.
  *
@@ -3776,11 +4011,23 @@ declare interface WeekdaysProps {
 }
 
 /**
- * Welcome screen suggestion item
+ * A welcome-screen group rendered as an outline button in the welcome row.
+ * Clicking the group opens a popover listing its `items`.
  */
 export declare type WelcomeScreenSuggestion = {
     icon: IconType;
-    message: string;
+    label: string;
+    items: WelcomeScreenSuggestionItem[];
+};
+
+/**
+ * A single sub-suggestion shown inside a welcome-screen group's popover.
+ * The `title` is the label users see; `prompt` is what gets sent to the AI
+ * when they click (falls back to `title` when omitted). They can diverge so
+ * you can show a short, scannable title while sending a fully-formed prompt.
+ */
+export declare type WelcomeScreenSuggestionItem = {
+    title: string;
     prompt?: string;
 };
 
@@ -3835,6 +4082,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -3884,11 +4136,6 @@ declare module "@tiptap/core" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
-}
-
-
 declare namespace F0GraphNodeWrapperInner {
     var displayName: string;
 }