@factorialco/f0-react 1.414.1 → 1.416.0

package/dist/f0.d.ts

@@ -7,7 +7,6 @@ import { AmountCellValue } from './f0';
 import { AmountCellValue as AmountCellValue_2 } from './types/amount';
 import { AnchorHTMLAttributes } from 'react';
 import { AriaAttributes } from 'react';
-import { AssistantMessageProps } from '@copilotkit/react-ui';
 import { AutoFill as AutoFill_2 } from 'react';
 import { AvatarListCellValue } from './f0';
 import { AvatarListCellValue as AvatarListCellValue_2 } from './types/avatarList';
@@ -81,6 +80,7 @@ import { HTMLAttributes } from 'react';
 import { IconCellValue } from './types/icon';
 import { ImgHTMLAttributes } from 'react';
 import { InFilterOptions } from './InFilter/types';
+import { InputProps } from '@copilotkit/react-ui';
 import { internalAvatarColors as internalAvatarColors_2 } from './f0';
 import { internalAvatarSizes as internalAvatarSizes_2 } from './f0';
 import { internalAvatarTypes as internalAvatarTypes_2 } from './f0';
@@ -90,7 +90,6 @@ import { LineChartPropsBase } from './utils/types';
 import { LocalAudioTrack } from 'livekit-client';
 import { LongTextCellValue } from './types/longText';
 import { Message } from '@copilotkit/shared';
-import { MessagesProps } from '@copilotkit/react-ui';
 import { NumberCellValue } from './f0';
 import { NumberCellValue as NumberCellValue_2 } from './types/number';
 import { NumberFilterOptions } from './NumberFilter/NumberFilter';
@@ -140,10 +139,9 @@ import { WithDataTestIdReturnType as WithDataTestIdReturnType_7 } from './f0';
 import { z } from 'zod';
 import { ZodEffects } from 'zod';
 import { ZodRawShape } from 'zod';
+import { ZodType } from 'zod';
 import { ZodTypeAny } from 'zod';
 
-export declare function A({ children, ...props }: React.AnchorHTMLAttributes<HTMLAnchorElement>): JSX_2.Element;
-
 export declare type Action = UpsellAction | RegularAction;
 
 declare type Action_2 = {
@@ -302,7 +300,26 @@ declare type AddRowActionsResult = PrimaryActionItemDefinition | PrimaryActionIt
 
 /* Excluded from this release type: AgentState */
 
-export declare type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
+declare type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
+
+/**
+ * Credits configuration for the AI chat.
+ * Groups all credits-related props into a single object.
+ *
+ * When provided, a credits button is shown in the chat header.
+ */
+export declare type AiChatCredits = {
+    /** Async function to fetch credits usage. Called each time the popover opens. */
+    fetchUsage: () => Promise<CreditsUsage>;
+    /** URL to the plan upgrade page. When provided, a link is shown in the popover. */
+    upgradePlanUrl?: string;
+    /** Company name displayed in the popover header. */
+    companyName?: string;
+    /** Company logo URL displayed in the popover header. */
+    companyLogoUrl?: string;
+    /** Plan name displayed below the company name (e.g. "Free plan", "Enterprise"). */
+    planName?: string;
+};
 
 /**
  * Disclaimer configuration for the chat input
@@ -371,6 +388,11 @@ export declare type AiChatProviderProps = {
      * 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.
+     */
+    credits?: AiChatCredits;
     onThumbsUp?: (message: AIMessage, { threadId, feedback }: {
         threadId: string;
         feedback: string;
@@ -476,7 +498,11 @@ declare type AiChatProviderReturnValue = {
      * Set the footer content. Use this to update the footer from outside the provider (e.g. per page/route).
      */
     setFooter: React.Dispatch<React.SetStateAction<React.ReactNode | undefined>>;
-} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityResolvers" | "toolHints"> & {
+    /** Whether the assistant is currently generating a response */
+    inProgress: boolean;
+    /** Set the in-progress state (synced from CopilotKit's isLoading) */
+    setInProgress: (value: boolean) => void;
+} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityResolvers" | "toolHints" | "credits"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
     /** Open the canvas panel with the given content */
@@ -507,6 +533,7 @@ declare interface AiChatState {
     VoiceMode?: React.ComponentType;
     entityResolvers?: EntityResolvers;
     toolHints?: AiChatToolHint[];
+    credits?: AiChatCredits;
     placeholders?: string[];
     setPlaceholders?: React.Dispatch<React.SetStateAction<string[]>>;
     onThumbsUp?: (message: AIMessage, { threadId, feedback }: {
@@ -569,73 +596,109 @@ export declare interface AiChatTranslationsProviderProps {
 }
 
 /**
- * Default AI chat translations
+ * Default AI chat translations — derived from the global defaultTranslations
+ * to avoid manual duplication.
  */
 export declare const aiTranslations: {
     ai: {
-        openChat: string;
-        closeChat: string;
-        startNewChat: string;
-        scrollToBottom: string;
-        welcome: string;
-        defaultInitialMessage: string;
-        inputPlaceholder: string;
-        stopAnswerGeneration: string;
-        responseStopped: string;
-        sendMessage: string;
-        thoughtsGroupTitle: string;
-        resourcesGroupTitle: string;
-        thinking: string;
-        closeDashboard: string;
-        exportTable: string;
-        generatedTableFilename: string;
-        feedbackModal: {
-            positive: {
-                title: string;
-                label: string;
-                placeholder: string;
+        readonly openChat: "Open Chat with One AI";
+        readonly closeChat: "Close Chat with One AI";
+        readonly startNewChat: "Start new chat";
+        readonly settings: "Settings";
+        readonly scrollToBottom: "Scroll to bottom";
+        readonly welcome: "Ask or create with One";
+        readonly defaultInitialMessage: "How can I help you today?";
+        readonly inputPlaceholder: "Ask about time, people, or company info and a lot of other things...";
+        readonly stopAnswerGeneration: "Stop generating";
+        readonly responseStopped: "You stopped this response";
+        readonly sendMessage: "Send message";
+        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: {
+            readonly positive: {
+                readonly title: "What did you like about this response?";
+                readonly label: "Your feedback helps us make Factorial AI better";
+                readonly placeholder: "Share what worked well";
             };
-            negative: {
-                title: string;
-                label: string;
-                placeholder: string;
+            readonly negative: {
+                readonly title: "What could have been better?";
+                readonly label: "Your feedback helps us improve future answers";
+                readonly placeholder: "Share what didn’t work";
             };
         };
-        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;
+        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 credits: {
+            readonly title: "Credits";
+            readonly creditsLeft: "{{total}} left";
+            readonly monthlyCredits: "Monthly credits";
+            readonly creditsError: "Could not load credits";
+            readonly upgradePlan: "Upgrade";
+            readonly needMoreCredits: "Need more credits?";
         };
-        dataDownload: {
-            download: string;
+        readonly reportCard: {
+            readonly reportLabel: "Report";
+            readonly openButton: "Open";
+        };
+        readonly dataDownload: {
+            readonly download: "Download {{format}}";
+            readonly exportDashboard: "Export dashboard as {{format}}";
+            readonly exporting: "Exporting...";
+        };
+        readonly pong: {
+            readonly title: "Pong";
+            readonly youWin: "You win!";
+            readonly youLose: "You lose!";
+            readonly goal: "Goal";
+            readonly controls: "← → to move";
+            readonly escToExit: "Esc to exit";
         };
-        pong: {
-            ai: string;
-            you: string;
-            youWin: string;
-            youLose: string;
+        readonly growth: {
+            readonly demoCard: {
+                readonly title: "See {{moduleName}} in action";
+                readonly actionLabel: "Start demo";
+            };
+            readonly bookAMeetingCard: {
+                readonly title: "Talk with an expert";
+                readonly schedule: "Mon-Fri · 09:00-21:00 (CEST)";
+                readonly actionLabel: "Book a meeting";
+            };
+            readonly questionCard: {
+                readonly actionLabel: "Next";
+                readonly skipLabel: "Skip";
+                readonly sendLabel: "Send";
+            };
+            readonly moduleCard: {
+                readonly actionLabel: "Learn more";
+            };
+            readonly faqCard: {
+                readonly title: "Questions before getting started";
+            };
         };
-        unsavedChanges: string;
-        saveChanges: string;
-        discardChanges: string;
     };
 };
 
@@ -694,6 +757,18 @@ blurArea?: "l" | "r" | "lr";
 
 declare type AsAllowedList = (typeof allTags)[number];
 
+/**
+ * Accepts either a synchronous value or an async function that resolves it.
+ * The async function receives an `AbortSignal` for cancellation support.
+ */
+export declare type AsyncOrSync<T> = T | ((signal: AbortSignal) => Promise<T>);
+
+/**
+ * Async function that receives typed params (from AI presentForm).
+ * Use this variant when `defaultValuesParamsSchema` is provided.
+ */
+declare type AsyncWithParams<T, TParams> = (params: TParams) => Promise<T>;
+
 declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & {
     size?: (typeof internalAvatarSizes)[number];
     type?: (typeof internalAvatarTypes)[number];
@@ -1039,8 +1114,6 @@ export declare type BigNumberProps = {
     comparison: Numeric | NumberWithFormatter | number;
 };
 
-export declare function Blockquote({ children, ...props }: React.HTMLAttributes<HTMLQuoteElement>): JSX_2.Element;
-
 /**
  * Base for boolean-specific conditions
  */
@@ -1348,13 +1421,13 @@ export declare type CanvasContentBase = {
  * Contract for a canvas entity type.
  *
  * Each entity (dashboard, survey, goal, job-posting…) implements this
- * interface and registers itself via `registerCanvasEntity()`.
+ * 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 `CanvasEntityDefinition` in `index.ts`
- * 4. Import the entity module in `canvas/index.ts`
+ * 3. Implement and export `CanvasEntityDefinition` in `index.tsx`
+ * 4. Add the entity to the record in `canvas/registry.ts`
  */
 export declare type CanvasEntityDefinition<T extends CanvasContentBase = CanvasContentBase> = {
     /** Must match the `type` discriminant on the content object */
@@ -1364,13 +1437,14 @@ export declare type CanvasEntityDefinition<T extends CanvasContentBase = CanvasC
         content: T;
         refreshKey: number;
     }) => ReactNode;
-    /** Renders header actions (placed before the close button) */
-    renderHeaderActions: (props: {
+    /** Renders the full header (title, actions, close button) */
+    renderHeader: (props: {
         content: T;
+        onClose: () => void;
     }) => ReactNode;
     /**
      * Optional wrapper providing entity-scoped context around
-     * both header actions and body (e.g. shared edit-mode state).
+     * both header and body (e.g. shared edit-mode state).
      */
     wrapper?: (props: {
         content: T;
@@ -1593,7 +1667,7 @@ declare type ChartColorToken = (typeof chartColorTokens)[number];
  */
 declare const chartColorTokens: readonly ["lilac", "barbie", "smoke", "army", "flubber", "indigo", "camel", "radical", "viridian", "orange", "red", "grass", "malibu", "yellow", "purple"];
 
-export declare interface ChartComputation {
+declare interface ChartComputation {
     datasetId: string;
     xAxis: string;
     yAxis: string;
@@ -1617,13 +1691,13 @@ declare interface ChartConfigBase {
     categoryFormatter?: (value: string) => string;
 }
 
-export declare interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
+declare interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
     type: "bar";
     orientation?: "vertical" | "horizontal";
     stacked?: boolean;
 }
 
-export declare type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig;
+declare type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig;
 
 declare interface ChatDashboardChartConfigBase {
     showLegend?: boolean;
@@ -1632,19 +1706,19 @@ declare interface ChatDashboardChartConfigBase {
     valueFormat?: FormatPreset;
 }
 
-export declare interface ChatDashboardChartItem extends ChatDashboardItemBase {
+declare interface ChatDashboardChartItem extends ChatDashboardItemBase {
     type: "chart";
     chart: ChatDashboardChartConfig;
     computation: ChartComputation | RadarComputation | PieComputation | GaugeComputation | HeatmapComputation;
 }
 
-export declare interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
+declare interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
     type: "collection";
     columns: ChatDashboardColumn[];
     computation: CollectionComputation;
 }
 
-export declare interface ChatDashboardColumn {
+declare interface ChatDashboardColumn {
     /** Column key — must match a key in each row object */
     id: string;
     /** Display header label */
@@ -1658,7 +1732,7 @@ export declare interface ChatDashboardColumn {
  * Contains fetchSpecs that describe how to obtain data server-side —
  * no raw data is included. Fully JSON-serializable.
  */
-export declare interface ChatDashboardConfig {
+declare interface ChatDashboardConfig {
     /** Dashboard title displayed in the canvas header and chat report card */
     title: string;
     /** Filter definitions — keys become filter IDs */
@@ -1669,14 +1743,14 @@ export declare interface ChatDashboardConfig {
     fetchSpecs: Record<string, DashboardFetchSpec>;
 }
 
-export declare interface ChatDashboardFilterDefinition {
+declare interface ChatDashboardFilterDefinition {
     type: "in";
     label: string;
     column: string;
     datasetId: string;
 }
 
-export declare interface ChatDashboardFunnelChartConfig {
+declare interface ChatDashboardFunnelChartConfig {
     type: "funnel";
     sort?: "descending" | "ascending" | "none";
     orient?: "horizontal" | "vertical";
@@ -1704,7 +1778,7 @@ declare interface ChatDashboardHeatmapChartConfig {
     valueFormat?: FormatPreset;
 }
 
-export declare type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
+declare type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
 
 declare interface ChatDashboardItemBase {
     id: string;
@@ -1718,14 +1792,14 @@ declare interface ChatDashboardItemBase {
     y?: number;
 }
 
-export declare interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
+declare interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
     type: "line";
     lineType?: "linear" | "smooth" | "step";
     showArea?: boolean;
     showDots?: boolean;
 }
 
-export declare type ChatDashboardMetricFormat = {
+declare type ChatDashboardMetricFormat = {
     type: "number";
 } | {
     type: "currency";
@@ -1738,7 +1812,7 @@ export declare type ChatDashboardMetricFormat = {
     prefix?: string;
 };
 
-export declare interface ChatDashboardMetricItem extends ChatDashboardItemBase {
+declare interface ChatDashboardMetricItem extends ChatDashboardItemBase {
     type: "metric";
     format?: ChatDashboardMetricFormat;
     decimals?: number;
@@ -1761,6 +1835,10 @@ declare interface ChatDashboardRadarChartConfig extends ChatDashboardChartConfig
 
 export declare const ChatSpinner: ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & RefAttributes<SVGSVGElement>>;
 
+declare type ChatTextareaProps = InputProps & {
+    submitLabel?: string;
+};
+
 /**
  * All valid renderIf conditions for checkbox fields
  */
@@ -1880,7 +1958,7 @@ declare const chipVariants: (props?: ({
 
 declare type ColId = string;
 
-export declare interface CollectionComputation {
+declare interface CollectionComputation {
     datasetId: string;
     sortBy?: string;
     sortOrder?: "asc" | "desc";
@@ -2018,6 +2096,14 @@ export declare const createPageLayoutBlock: <Props = unknown>(displayName: strin
 
 export declare const createPageLayoutBlockGroup: <Props = unknown>(displayName: string, Component: React.ComponentType<Props>) => React.ComponentType<Props> & PageLayoutGroupComponent;
 
+/**
+ * Credits usage data returned by the host app
+ */
+export declare type CreditsUsage = {
+    used: number;
+    total: number;
+};
+
 /**
  * CSS RGB color string type
  * @example 'rgb(255, 0, 0)' or 'rgb(255,0,0)'
@@ -2070,6 +2156,8 @@ export declare interface CustomFieldRenderProps<TValue = unknown, TConfig = unde
     required?: boolean;
     /** Custom configuration passed via fieldConfig */
     config: TConfig;
+    /** Name identifying this custom field type (used with renderCustomField) */
+    customFieldName?: string;
 }
 
 /**
@@ -2096,6 +2184,8 @@ declare interface CustomFieldRenderPropsBase {
     disabled?: boolean;
     /** Whether the field is required (derived from Zod schema) */
     required?: boolean;
+    /** Name identifying this custom field type (used with renderCustomField) */
+    customFieldName?: string;
 }
 
 export declare const Dashboard: WithDataTestIdReturnType_3<ComponentType<DashboardProps_2> & PageLayoutGroupComponent_2>;
@@ -2112,17 +2202,6 @@ export declare type DashboardCanvasContent = CanvasContentBase & {
     };
 };
 
-/**
- * Dashboard-specific card that wraps CanvasCard with config-store
- * subscription logic. Re-renders when the user edits and saves
- * the dashboard layout.
- */
-declare function DashboardCard({ config: originalConfig, onView, toolCallId, }: F0ChatReportCardProps): JSX_2.Element;
-
-declare namespace DashboardCard {
-    var displayName: string;
-}
-
 /**
  * Chart display configuration — discriminated on `type`.
  * This object is JSON-serializable (no functions, except optional formatters).
@@ -2184,7 +2263,7 @@ export declare interface DashboardCollectionItem<Filters extends FiltersDefiniti
     visualizations: ReadonlyArray<any>;
 }
 
-export declare interface DashboardFetchSpec {
+declare interface DashboardFetchSpec {
     fetch: Array<{
         toolId: string;
         args: Record<string, unknown>;
@@ -3062,6 +3141,7 @@ export declare const defaultTranslations: {
         readonly openChat: "Open Chat with One AI";
         readonly closeChat: "Close Chat with One AI";
         readonly startNewChat: "Start new chat";
+        readonly settings: "Settings";
         readonly scrollToBottom: "Scroll to bottom";
         readonly welcome: "Ask or create with One";
         readonly defaultInitialMessage: "How can I help you today?";
@@ -3109,18 +3189,30 @@ export declare const defaultTranslations: {
         readonly ask: "Ask One";
         readonly viewProfile: "View profile";
         readonly tools: "Tools";
+        readonly credits: {
+            readonly title: "Credits";
+            readonly creditsLeft: "{{total}} left";
+            readonly monthlyCredits: "Monthly credits";
+            readonly creditsError: "Could not load credits";
+            readonly upgradePlan: "Upgrade";
+            readonly needMoreCredits: "Need more credits?";
+        };
         readonly reportCard: {
             readonly reportLabel: "Report";
             readonly openButton: "Open";
         };
         readonly dataDownload: {
             readonly download: "Download {{format}}";
+            readonly exportDashboard: "Export dashboard as {{format}}";
+            readonly exporting: "Exporting...";
         };
         readonly pong: {
-            readonly ai: "AI";
-            readonly you: "YOU";
+            readonly title: "Pong";
             readonly youWin: "You win!";
             readonly youLose: "You lose!";
+            readonly goal: "Goal";
+            readonly controls: "← → to move";
+            readonly escToExit: "Esc to exit";
         };
         readonly growth: {
             readonly demoCard: {
@@ -3347,6 +3439,38 @@ export declare const defaultTranslations: {
     };
 };
 
+/**
+ * Helper to define an available form with proper params typing.
+ * TypeScript infers `TParams` from `defaultValuesParamsSchema`, so the
+ * `defaultValues` callback receives fully typed params.
+ *
+ * @example
+ * ```tsx
+ * const employeeForm = defineAvailableForm({
+ *   name: "edit-employee",
+ *   schema: employeeSchema,
+ *   defaultValuesParamsSchema: z.object({ employeeId: z.string() }),
+ *   defaultValues: (params) => ({
+ *     // params.employeeId is typed as string
+ *     name: `Employee ${params.employeeId}`,
+ *   }),
+ * })
+ * ```
+ */
+export declare function defineAvailableForm<TParams extends Record<string, unknown> = Record<string, unknown>>(definition: F0AiAvailableFormDefinition<TParams>): F0AiAvailableFormDefinition<TParams>;
+
+/**
+ * Introspect an F0Form schema and return a serializable array of field descriptions.
+ * Pure function — usable outside React components.
+ *
+ * @example
+ * ```ts
+ * const fields = describeFormSchema(mySchema)
+ * // [{ name: "email", type: "text", label: "Email", required: true, ... }, ...]
+ * ```
+ */
+export declare function describeFormSchema(schema: F0FormSchema): FormFieldDescription[];
+
 export declare type DialogPosition = (typeof dialogPositions)[number];
 
 declare const dialogPositions: readonly ["center", "left", "right", "fullscreen"];
@@ -3543,8 +3667,6 @@ declare type EditableTableVisualizationSettings = TableVisualizationSettings;
 
 export declare type ElementType = QuestionType | "section";
 
-export declare function Em({ children, ...props }: React.HTMLAttributes<HTMLSpanElement>): JSX_2.Element;
-
 export declare function EmojiImage({ emoji, size, alt }: EmojiImageProps): JSX_2.Element;
 
 export declare interface EmojiImageProps extends VariantProps<typeof emojiVariants> {
@@ -3562,22 +3684,6 @@ declare const emojiVariants: (props?: ({
     className?: ClassValue;
 })) | undefined) => string;
 
-/**
- * Generic entity reference renderer for custom `<entity-ref>` HTML tags
- * embedded in AI chat markdown output.
- *
- * Dispatches to type-specific renderers based on the `type` attribute.
- * Falls back to rendering children as plain text for unknown types.
- *
- * Usage in markdown (via rehype-raw):
- *   <entity-ref type="person" id="123">Ana García</entity-ref>
- */
-export declare function EntityRef({ type, id, children, }: {
-    type?: string;
-    id?: string;
-    children?: ReactNode;
-}): JSX_2.Element;
-
 /**
  * Map of async resolver functions keyed by entity type.
  * Each resolver takes an entity ID and returns the profile data
@@ -3649,6 +3755,41 @@ export declare interface F0ActionItemProps {
     inGroup?: boolean;
 }
 
+/**
+ * A form definition that the AI can interact with even though the form is not rendered.
+ *
+ * Use the generic parameter to type the params accepted by a functional `defaultValues`.
+ * Prefer using {@link defineAvailableForm} for automatic inference from `defaultValuesParamsSchema`.
+ */
+export declare interface F0AiAvailableFormDefinition<TParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique name to identify the form */
+    name: string;
+    /** Zod schema that defines the form's fields and validation */
+    schema: F0FormSchema;
+    /**
+     * Default values for the form fields.
+     * Can be a static object or a function that receives params (supplied by the AI via presentForm)
+     * and returns the defaults.
+     */
+    defaultValues?: Record<string, unknown> | ((params: TParams) => Record<string, unknown>);
+    /**
+     * Zod schema that describes the params accepted by a functional `defaultValues`.
+     * When provided, the AI will see this schema and can supply params when calling presentForm.
+     * Params are validated against this schema before being passed to `defaultValues`.
+     */
+    defaultValuesParamsSchema?: ZodType<TParams>;
+    /** Section configs (title, description) keyed by section ID */
+    sections?: Record<string, F0SectionConfig>;
+    /** Optional submit handler. Called when AI triggers formSubmit on this form. */
+    onSubmit?: (values: Record<string, unknown>) => void | Promise<void>;
+    /** Title shown in the dialog header or wizard header */
+    title?: string;
+    /** Description shown under the title in dialog mode */
+    description?: string;
+    /** Wizard steps (required for wizard mode to work with multiple steps) */
+    steps?: F0WizardFormStep[];
+}
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -3657,85 +3798,91 @@ 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, historyEnabled, footer, VoiceMode, 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, VoiceMode, entityResolvers, toolHints, credits, 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;
+export declare const F0AiChatTextArea: ({ submitLabel, inProgress, onSend, onStop, }: ChatTextareaProps) => JSX_2.Element;
 
 /**
- * Props for the F0AiChatTextArea component
+ * Entry in the AI form registry
  */
-export declare interface F0AiChatTextAreaProps {
-    /**
-     * Whether the chat is currently processing a message
-     */
-    inProgress: boolean;
-    /**
-     * Callback when the user sends a message
-     */
-    onSend: (message: string) => void;
-    /**
-     * Callback when the user stops the current generation
-     */
-    onStop?: () => void;
-    /**
-     * Custom label for the submit button
-     */
-    submitLabel?: string;
-    /**
-     * Array of placeholder strings to cycle through with typewriter effect.
-     * If multiple placeholders are provided, they will animate in a cycle.
-     * If a single placeholder is provided, it will be displayed statically.
-     */
-    placeholders?: string[];
-    /**
-     * Default placeholder text when no placeholders are provided or as fallback
-     */
-    defaultPlaceholder?: string;
-    /**
-     * Whether the textarea should autofocus on mount
-     * @default true
-     */
-    autoFocus?: boolean;
-    /**
-     * Entity resolvers for @mention autocomplete and entity reference rendering.
-     * When `searchPersons` is provided, typing @ in the textarea opens an
-     * autocomplete popover to mention employees.
-     */
-    entityResolvers?: EntityResolvers;
-    /**
-     * Available tool hints that the user can activate.
-     * Renders a selector button to the left of the send button.
-     */
-    toolHints?: AiChatToolHint[];
-    /**
-     * The currently active tool hint, or null if none is selected.
-     */
-    activeToolHint?: AiChatToolHint | null;
-    /**
-     * Callback when the active tool hint changes (selection or removal).
-     */
-    onActiveToolHintChange?: (toolHint: AiChatToolHint | null) => void;
+export declare interface F0AiFormEntry {
+    ref: React.MutableRefObject<F0FormRef | null>;
+    schema: F0FormSchema;
+    /** Whether this entry was registered from an availableFormDefinition (not a rendered form) */
+    virtual?: boolean;
+    /** Section configs (title, description) keyed by section ID */
+    sections?: Record<string, F0SectionConfig>;
+    /** Zod schema for params accepted by presentForm (virtual entries only) */
+    defaultValuesParamsSchema?: ZodType;
+    /** Raw defaultValues function that accepts params (from rendered forms with defaultValuesParamsSchema) */
+    defaultValuesFn?: (params: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    /** Field names explicitly set via setValue/setValues on a virtual ref */
+    dirtyFields?: Set<string>;
+}
+
+/**
+ * Context value for the AI form registry
+ */
+declare interface F0AiFormRegistryContextValue {
+    register: (name: string, ref: React.MutableRefObject<F0FormRef | null>, schema: F0FormSchema, sections?: Record<string, F0SectionConfig>, defaultValuesParamsSchema?: ZodType, defaultValuesFn?: (params: Record<string, unknown>) => Promise<Record<string, unknown>>) => void;
+    unregister: (name: string) => void;
+    get: (name: string) => F0AiFormEntry | undefined;
+    getFormNames: () => string[];
+    /** Rebuild the form descriptions snapshot (call after mutating form state) */
+    rebuildDescriptions: () => void;
+    /** Structured descriptions of all active forms, updated on register/unregister */
+    formDescriptions: {
+        formName: string;
+        formSchema: Record<string, unknown>;
+        fieldDescriptions: Record<string, {
+            label: string;
+            section?: string;
+            placeholder?: string;
+            helpText?: string;
+            description?: string;
+        }>;
+        sectionDescriptions: Record<string, {
+            title: string;
+            description?: string;
+        }>;
+        formValues: Record<string, unknown>;
+        formErrors: Record<string, unknown>;
+        isDirty: boolean;
+        /** JSON Schema of defaultValuesParams accepted by presentForm (only for forms with defaultValuesParamsSchema) */
+        defaultValuesParamsSchema?: Record<string, unknown>;
+    }[];
+    /** Currently AI-presented form, or null */
+    presentedForm: F0AiPresentedForm | null;
+    /** Called by the AI tool to present a form */
+    presentForm: (formName: string, mode: "dialog" | "wizard", defaultValuesParams?: Record<string, unknown>) => {
+        success: boolean;
+        error?: string;
+    };
+    /** Called when the presented form is closed (submit/cancel) */
+    dismissForm: () => void;
 }
 
-export declare const F0AiCollapsibleMessage: ({ icon, title, children, }: F0AiCollapsibleMessageProps) => JSX_2.Element;
-
 /**
- * Props for the F0AiCollapsibleMessage component
+ * Provider that maintains a registry of active F0Forms,
+ * enabling AI tools to look up forms by name.
+ *
+ * Place this inside both the CopilotKit provider and above the F0Form components.
+ *
+ * @example
+ * ```tsx
+ * <F0AiChatProvider>
+ *   <F0AiFormRegistryProvider>
+ *     <F0Form name="my-form" ... />
+ *     <F0AiChat />
+ *   </F0AiFormRegistryProvider>
+ * </F0AiChatProvider>
+ * ```
  */
-export declare interface F0AiCollapsibleMessageProps {
-    /**
-     * Icon to display in the collapsible trigger
-     */
-    icon: IconType;
-    /**
-     * Title text for the collapsible trigger
-     */
-    title: string;
-    /**
-     * Content to show when expanded
-     */
-    children: ReactNode;
-}
+export declare function F0AiFormRegistryProvider({ children, availableFormDefinitions, }: {
+    children: React.ReactNode;
+    /** Form definitions the AI can interact with even if the form is not rendered on the page */
+    availableFormDefinitions?: F0AiAvailableFormDefinition[];
+}): JSX_2.Element;
 
 /**
  * @experimental This is an experimental component use it at your own risk
@@ -3771,6 +3918,20 @@ export declare class F0AiMask {
     private render;
 }
 
+/**
+ * Tracks an AI-presented form (opened via the presentForm tool)
+ */
+export declare interface F0AiPresentedForm {
+    /** Name of the form (matches an availableFormDefinition) */
+    name: string;
+    /** Render mode chosen by the LLM */
+    mode: "dialog" | "wizard";
+    /** Resolved definition from availableFormDefinitions */
+    definition: F0AiAvailableFormDefinition;
+    /** Snapshot of the virtual form's values at the time presentForm was called */
+    initialValues: Record<string, unknown>;
+}
+
 export declare const F0Alert: WithDataTestIdReturnType_3<({ title, description, action, link, icon, variant, }: F0AlertProps) => JSX_2.Element>;
 
 export declare interface F0AlertProps {
@@ -3793,7 +3954,7 @@ export declare interface F0AlertProps {
  * @experimental This is an experimental component use it at your own risk
  */
 export declare const F0AnalyticsDashboard: {
-    <Filters extends FiltersDefinition_2 = FiltersDefinition_2>({ filters, presets, defaultFilters, items, editMode, onLayoutChange, }: F0AnalyticsDashboardProps_2<Filters>): JSX_2.Element;
+    <Filters extends FiltersDefinition_2 = FiltersDefinition_2>({ filters, presets, defaultFilters, items, editMode, onLayoutChange, enableExport, exportFilename, onExportReady, }: F0AnalyticsDashboardProps_2<Filters>): JSX_2.Element;
     displayName: string;
 };
 
@@ -3836,6 +3997,22 @@ export declare interface F0AnalyticsDashboardProps<Filters extends FiltersDefini
      * the consumer can reconcile against the original config items.
      */
     onLayoutChange?: (layout: DashboardItemLayout[]) => void;
+    /**
+     * Show a dashboard-level export button (PDF/Excel).
+     * @default false
+     */
+    enableExport?: boolean;
+    /**
+     * Called when the export function becomes available (or undefined on unmount).
+     * Allows a parent to trigger export imperatively without rendering the
+     * built-in ExportDropdown.
+     */
+    /**
+     * Custom filename for the exported Excel file (without extension).
+     * @default "dashboard"
+     */
+    exportFilename?: string;
+    onExportReady?: (exportFn: (() => Promise<void>) | undefined) => void;
 }
 
 /**
@@ -4110,6 +4287,12 @@ export declare interface F0BaseConfig {
      * renderIf: ({ values }) => values.status === 'active'
      */
     renderIf?: F0BaseFieldRenderIfProp;
+    /**
+     * Name identifying a reusable custom field type.
+     * When set, the form-level `renderCustomField` callback is invoked to provide
+     * field-specific configuration (e.g. data source, options) or a custom component.
+     */
+    customFieldName?: string;
 }
 
 /**
@@ -4145,6 +4328,11 @@ export declare interface F0BaseField {
      * @default false
      */
     resetOnDisable?: boolean;
+    /**
+     * Name identifying a reusable custom field type.
+     * Used with the form-level `renderCustomField` callback.
+     */
+    customFieldName?: string;
 }
 
 /**
@@ -4353,21 +4541,6 @@ compact?: boolean;
 
 export declare type F0CardProps = Omit<CardInternalProps, (typeof privateProps_3)[number]>;
 
-/**
- * @deprecated Use `DashboardCard` from `canvas/entities/dashboard` directly.
- * This re-export exists for backwards compatibility.
- */
-export declare const F0ChatReportCard: typeof DashboardCard;
-
-export declare type 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;
-};
-
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -4448,10 +4621,15 @@ export declare type F0CustomConfig<TValue = unknown, TConfig = undefined> = TCon
  *
  * @typeParam TValue - Type of the field value
  */
-declare interface F0CustomConfigBase<TValue = unknown> {
+declare type F0CustomConfigBase<TValue = unknown> = {
     /** Render function for the custom component */
     render: (props: CustomFieldRenderProps<TValue, undefined>) => ReactNode;
-}
+} | {
+    /** Name identifying this custom field type (resolved by renderCustomField on the form) */
+    customFieldName: string;
+    /** Optional render function (overridden by form-level renderCustomField when customFieldName is set) */
+    render?: (props: CustomFieldRenderProps<TValue, undefined>) => ReactNode;
+};
 
 /**
  * Custom config with fieldConfig (render receives typed config)
@@ -4459,12 +4637,19 @@ declare interface F0CustomConfigBase<TValue = unknown> {
  * @typeParam TValue - Type of the field value
  * @typeParam TConfig - Type of the fieldConfig object
  */
-declare interface F0CustomConfigWithFieldConfig<TValue = unknown, TConfig = unknown> {
+declare type F0CustomConfigWithFieldConfig<TValue = unknown, TConfig = unknown> = {
     /** Custom configuration to pass to the render function */
     fieldConfig: TConfig;
     /** Render function for the custom component */
     render: (props: CustomFieldRenderProps<TValue, TConfig>) => ReactNode;
-}
+} | {
+    /** Custom configuration to pass to the render function */
+    fieldConfig: TConfig;
+    /** Name identifying this custom field type (resolved by renderCustomField on the form) */
+    customFieldName: string;
+    /** Optional render function (overridden by form-level renderCustomField when customFieldName is set) */
+    render?: (props: CustomFieldRenderProps<TValue, TConfig>) => ReactNode;
+};
 
 /**
  * Custom field with all properties for rendering (runtime type)
@@ -4472,11 +4657,13 @@ declare interface F0CustomConfigWithFieldConfig<TValue = unknown, TConfig = unkn
 export declare type F0CustomField = F0BaseField & {
     type: "custom";
     /** Render function for the custom component */
-    render: (props: CustomFieldRenderPropsBase & {
+    render?: (props: CustomFieldRenderPropsBase & {
         config: unknown;
     }) => ReactNode;
     /** Custom configuration (if provided) */
     fieldConfig?: unknown;
+    /** Name identifying this custom field type (resolved by renderCustomField on the form) */
+    customFieldName?: string;
     /** Conditional rendering based on another field's value */
     renderIf?: CustomFieldRenderIf;
 };
@@ -4632,68 +4819,6 @@ declare interface F0DataChartRadarSeries {
     color?: ChartColorToken;
 }
 
-/**
- * Component that renders an optional markdown preview followed by
- * a dropdown button with "Download Excel" as the primary action and
- * "Download CSV" as a secondary option. Files are generated client-side
- * from the raw dataset provided by the agent.
- */
-export declare const F0DataDownload: ({ markdown, filename, dataset, }: F0DataDownloadProps) => JSX_2.Element;
-
-/**
- * Inline dataset for client-side file generation (Excel / CSV).
- * Sent by the agent with the raw query results.
- */
-export declare type F0DataDownloadDataset = {
-    /**
-     * Column headers in display order.
-     */
-    columns: string[];
-    /**
-     * Array of row objects keyed by column name.
-     */
-    rows: Record<string, unknown>[];
-    /**
-     * Total number of rows returned by the query (before truncation).
-     * Used together with previewCount to render the preview note.
-     */
-    totalCount?: number;
-    /**
-     * Number of rows shown in the markdown preview table.
-     * Used together with totalCount to render the preview note.
-     */
-    previewCount?: number;
-    /**
-     * Map of raw column names to human-readable labels in the user's language.
-     * Used for Excel/CSV headers. Falls back to the raw column name when absent.
-     */
-    columnLabels?: Record<string, string>;
-};
-
-/**
- * Props for the F0DataDownload component.
- *
- * Renders an optional markdown preview/description followed by
- * "Download Excel" and "Download CSV" buttons. The component generates
- * the files client-side from the provided dataset.
- */
-export declare type F0DataDownloadProps = {
-    /**
-     * Optional markdown content to display above the download buttons.
-     * Typically a 5-row preview table generated by the agent.
-     */
-    markdown?: string;
-    /**
-     * Descriptive filename (without extension) for the downloaded files.
-     * Generated by the AI to reflect the query content in the user's language.
-     */
-    filename?: string;
-    /**
-     * Raw dataset for client-side Excel and CSV generation.
-     */
-    dataset: F0DataDownloadDataset;
-};
-
 /**
  * F0 config options specific to date fields
  *
@@ -5166,6 +5291,14 @@ export declare interface F0FormDefinitionPerSection<T extends F0PerSectionSchema
     onSubmit: (arg: F0WizardFormPerSectionSubmitArg<T>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
     submitConfig?: F0PerSectionSubmitConfig;
     errorTriggerMode?: F0FormErrorTriggerMode;
+    /** Whether async defaultValues are still being resolved */
+    isLoading?: boolean;
+    /** Zod schema describing params the AI can supply when calling presentForm */
+    defaultValuesParamsSchema?: ZodType;
+    /** Raw defaultValues function for AI registry use when params are involved */
+    defaultValuesFn?: (params: Record<string, unknown>) => Promise<{
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    }>;
 }
 
 export declare interface F0FormDefinitionSingleSchema<TSchema extends F0FormSchema_2> {
@@ -5177,6 +5310,12 @@ export declare interface F0FormDefinitionSingleSchema<TSchema extends F0FormSche
     onSubmit: (arg: F0WizardFormSingleSubmitArg<TSchema>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
     submitConfig?: F0FormSubmitConfig;
     errorTriggerMode?: F0FormErrorTriggerMode;
+    /** Whether async defaultValues are still being resolved */
+    isLoading?: boolean;
+    /** Zod schema describing params the AI can supply when calling presentForm */
+    defaultValuesParamsSchema?: ZodType;
+    /** Raw defaultValues function for AI registry use when params are involved */
+    defaultValuesFn?: (params: Record<string, unknown>) => Promise<Partial<z.infer<TSchema>>>;
 }
 
 /**
@@ -5349,6 +5488,17 @@ export declare interface F0FormPropsWithPerSectionDefinition<T extends F0PerSect
     styling?: F0FormStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
+    /**
+     * Callback that renders custom fields identified by `customFieldName`.
+     * When a field has `customFieldName`, this function is called instead of the inline `render`.
+     */
+    renderCustomField?: RenderCustomFieldFunction;
+    /**
+     * Whether async defaultValues are still being resolved.
+     * When true, the form renders with loading indicators inside each field
+     * instead of replacing the entire form with skeleton placeholders.
+     */
+    isLoading?: boolean;
 }
 
 /**
@@ -5392,6 +5542,17 @@ export declare interface F0FormPropsWithPerSectionSchema<T extends F0PerSectionS
      * `defaultValues` against `InitialFile.value`.
      */
     initialFiles?: InitialFile[];
+    /**
+     * Callback that renders custom fields identified by `customFieldName`.
+     * When a field has `customFieldName`, this function is called instead of the inline `render`.
+     */
+    renderCustomField?: RenderCustomFieldFunction;
+    /**
+     * Whether async defaultValues are still being resolved.
+     * When true, the form renders with loading indicators inside each field
+     * instead of replacing the entire form with skeleton placeholders.
+     */
+    isLoading?: boolean;
 }
 
 /**
@@ -5436,6 +5597,27 @@ export declare interface F0FormPropsWithSingleSchema<TSchema extends F0FormSchem
      * `defaultValues` against `InitialFile.value`.
      */
     initialFiles?: InitialFile[];
+    /**
+     * Callback that renders custom fields identified by `customFieldName`.
+     * When a field has `customFieldName`, this function is called instead of the inline `render`.
+     */
+    renderCustomField?: RenderCustomFieldFunction;
+    /**
+     * Whether async defaultValues are still being resolved.
+     * When true, the form renders with loading indicators inside each field
+     * instead of replacing the entire form with skeleton placeholders.
+     */
+    isLoading?: boolean;
+    /**
+     * Zod schema describing params the AI can supply when calling presentForm.
+     * Passed through to the AI form registry.
+     */
+    defaultValuesParamsSchema?: ZodType;
+    /**
+     * Raw defaultValues function for the AI registry to call with params.
+     * Set automatically when using `useF0FormDefinition` with a functional `defaultValues`.
+     */
+    defaultValuesFn?: (params: Record<string, unknown>) => Promise<Record<string, unknown>>;
 }
 
 /**
@@ -5449,6 +5631,11 @@ export declare interface F0FormPropsWithSingleSchemaDefinition<TSchema extends F
     styling?: F0FormStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
+    /**
+     * Callback that renders custom fields identified by `customFieldName`.
+     * When a field has `customFieldName`, this function is called instead of the inline `render`.
+     */
+    renderCustomField?: RenderCustomFieldFunction;
 }
 
 /**
@@ -5473,6 +5660,27 @@ export declare interface F0FormRef {
      * Get the current form values (including unsaved changes)
      */
     getValues: () => Record<string, unknown>;
+    /**
+     * Set a single field value programmatically
+     */
+    setValue: (fieldName: string, value: unknown, options?: F0FormSetValueOptions) => void;
+    /**
+     * Set multiple field values at once
+     */
+    setValues: (values: Record<string, unknown>, options?: F0FormSetValueOptions) => void;
+    /**
+     * Manually trigger validation for a specific field or all fields
+     * @returns true if validation passes
+     */
+    trigger: (fieldName?: string) => Promise<boolean>;
+    /**
+     * Get current validation errors as a map of field name to error message
+     */
+    getErrors: () => Record<string, string>;
+    /**
+     * Get the list of field names in the form
+     */
+    getFieldNames: () => string[];
     /* Excluded from this release type: _setStateCallback */
 }
 
@@ -5483,6 +5691,14 @@ export declare type F0FormSchema<T extends ZodRawShape = ZodRawShape> = z.ZodObj
 
 declare type F0FormSchema_2<T extends ZodRawShape = ZodRawShape> = z.ZodObject<T> | ZodEffects<z.ZodObject<T>>;
 
+/**
+ * Options for setValue
+ */
+export declare interface F0FormSetValueOptions {
+    shouldValidate?: boolean;
+    shouldDirty?: boolean;
+}
+
 /**
  * Callback to update form state in the hook
  */
@@ -5619,26 +5835,6 @@ export declare type F0LinkProps = Omit<ActionLinkProps, "variant" | "href"> & {
     href?: string;
 };
 
-export declare const f0MarkdownRenderers: NonNullable<AssistantMessageProps["markdownTagRenderers"]>;
-
-/**
- * Markdown renderers without the table download button.
- * Use this when the parent component already provides its own download controls.
- */
-export declare const f0MarkdownRenderersSimple: NonNullable<AssistantMessageProps["markdownTagRenderers"]>;
-
-export declare const F0MessageSources: ({ sources }: F0MessageSourcesProps) => JSX_2.Element | null;
-
-/**
- * Props for the F0MessageSources component
- */
-export declare type F0MessageSourcesProps = {
-    /**
-     * Array of sources to display
-     */
-    sources: F0Source[];
-};
-
 /**
  * F0 config options specific to number fields
  *
@@ -5904,6 +6100,7 @@ declare type F0SelectBaseProps<T extends string, R = unknown> = {
  * Supports either:
  * - Static `options` array
  * - Dynamic `source` with `mapOptions` function
+ * - Runtime-provided via `customFieldName` (no options/source needed at definition time)
  *
  * @typeParam T - The value type (string or number)
  * @typeParam R - Record type from the data source
@@ -5911,7 +6108,7 @@ declare type F0SelectBaseProps<T extends string, R = unknown> = {
  * Note: `clearable` is derived from the Zod schema:
  * - `z.string().optional()` or `z.string().nullable()` → clearable
  */
-export declare type F0SelectConfig<T extends SelectValueType = string, R extends RecordType = RecordType> = F0SelectConfigWithOptions<T> | F0SelectConfigWithSource<T, R>;
+export declare type F0SelectConfig<T extends SelectValueType = string, R extends RecordType = RecordType> = F0SelectConfigWithOptions<T> | F0SelectConfigWithSource<T, R> | F0SelectConfigWithCustomFieldName;
 
 /**
  * Base config options shared by all select field variants
@@ -5925,6 +6122,18 @@ declare interface F0SelectConfigBase {
     searchBoxPlaceholder?: string;
 }
 
+/**
+ * Config for select fields whose options/source are provided at runtime
+ * via `customFieldName` and `renderCustomField`.
+ */
+declare interface F0SelectConfigWithCustomFieldName extends F0SelectConfigBase {
+    options?: never;
+    source?: never;
+    mapOptions?: never;
+    /** Required: identifies the custom field provider */
+    customFieldName: string;
+}
+
 /**
  * Config for select fields with static options
  * @typeParam T - The value type (string or number)
@@ -6043,28 +6252,6 @@ export declare type F0SelectTagProp = string | {
     src?: string;
 };
 
-/**
- * Source object for message sources
- */
-export declare type F0Source = {
-    /**
-     * 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;
-};
-
 /**
  * Union of all string field configs
  *
@@ -6227,38 +6414,6 @@ export declare type F0TextProps = Omit<TextProps, "className" | "variant" | "as"
     markdown?: boolean;
 };
 
-export declare const F0Thinking: ({ messages, title }: F0ThinkingProps) => JSX_2.Element;
-
-/**
- * Props for the F0Thinking component
- */
-export declare type F0ThinkingProps = {
-    /**
-     * Array of thinking/reflection messages to display
-     */
-    messages: Message[];
-    /**
-     * Whether the thinking process is currently active
-     */
-    isActive?: boolean;
-    /**
-     * Custom render function for messages
-     */
-    RenderMessage?: MessagesProps["RenderMessage"];
-    /**
-     * Custom assistant message component
-     */
-    AssistantMessage?: MessagesProps["AssistantMessage"];
-    /**
-     * Whether the chat is currently in progress
-     */
-    inProgress?: boolean;
-    /**
-     * Custom title for the thinking section
-     */
-    title?: string;
-};
-
 /**
  * F0 config options specific to time fields
  *
@@ -6335,6 +6490,11 @@ declare interface F0WizardFormBaseProps {
      * @default false
      */
     autoSkipCompletedSteps?: boolean;
+    /**
+     * Callback that renders custom fields identified by `customFieldName`.
+     * When a field has `customFieldName`, this function is called instead of the inline `render`.
+     */
+    renderCustomField?: RenderCustomFieldFunction;
 }
 
 export declare interface F0WizardFormPerSectionProps<T extends F0PerSectionSchema_2> extends F0WizardFormBaseProps {
@@ -6652,7 +6812,7 @@ declare const fontSizes: readonly ["sm", "md", "lg"];
  * real formatter function. The wrapper component maps these to actual
  * `(value: number) => string` functions at render time.
  */
-export declare type FormatPreset = {
+declare type FormatPreset = {
     type: "number";
 } | {
     type: "currency";
@@ -6665,6 +6825,26 @@ export declare type FormatPreset = {
 
 /* Excluded from this release type: FormDefinitionItem */
 
+/**
+ * Serializable description of a single form field,
+ * intended for AI tools to understand form structure.
+ */
+export declare interface FormFieldDescription {
+    name: string;
+    type: F0FieldType;
+    label: string;
+    required: boolean;
+    placeholder?: string;
+    helpText?: string;
+    options?: {
+        label: string;
+        value: string | number;
+    }[];
+    optionsSource?: "dynamic";
+    section?: string;
+    customFieldName?: string;
+}
+
 /**
  * Standalone form field props — decoupled from react-hook-form.
  * This is the minimal contract that field renderers need to operate.
@@ -6685,16 +6865,6 @@ export declare interface FormFieldProps {
 /** Fraction tokens for proportional widths */
 export declare type FractionToken = "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "5/6";
 
-export declare const FullscreenChatContext: Context<FullscreenChatContextType>;
-
-/**
- * Context type for fullscreen chat state
- */
-declare type FullscreenChatContextType = {
-    inProgress: boolean;
-    setInProgress: (value: boolean) => void;
-};
-
 export declare interface FunnelChartConfig {
     type: "funnel";
     /** Sort direction of funnel stages. @default "descending" */
@@ -6784,8 +6954,8 @@ export declare const getAnimationVariants: (options?: AnimationVariantsOptions)
 };
 
 /**
- * Look up a registered entity definition by content type.
- * Returns `undefined` if the type hasn't been registered.
+ * Look up a canvas entity definition by content type.
+ * Returns `undefined` if the type is not configured.
  */
 export declare function getCanvasEntity(type: string): CanvasEntityDefinition<any> | undefined;
 
@@ -6957,12 +7127,6 @@ export declare type GroupRecord<RecordType> = {
     records: RecordType[];
 };
 
-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;
-
 /**
  * Check if a schema has F0 config
  */
@@ -7005,8 +7169,6 @@ widgets?: ReactNode[];
 children?: ReactNode;
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
 
-export declare function Hr({ ...props }: React.HTMLAttributes<HTMLHRElement>): JSX_2.Element;
-
 declare type I18nContextType = TranslationsType & {
     t: (key: TranslationKey, args?: Record<string, string | number>) => string;
 };
@@ -7046,9 +7208,6 @@ declare type IdStructure = {
     children?: IdStructure[];
 };
 
-declare function Image_2({ src, alt, ...props }: React.ImgHTMLAttributes<HTMLImageElement>): JSX_2.Element;
-export { Image_2 as Image }
-
 declare type ImageContextValue = {
     src?: (props: ImageProps) => SrcProps;
 };
@@ -7396,8 +7555,6 @@ export declare type Level = (typeof levels)[number];
 
 declare const levels: readonly ["info", "warning", "critical", "positive"];
 
-export declare function Li({ children, ...props }: React.HTMLAttributes<HTMLLIElement>): JSX_2.Element;
-
 export declare const LineChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig_2> & {
 lineType?: "natural" | "linear";
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
@@ -7601,7 +7758,7 @@ declare interface MetadataProps {
     collapse?: boolean;
 }
 
-export declare interface MetricComputation {
+declare interface MetricComputation {
     datasetId: string;
     aggregation: AggregationType;
     column?: string;
@@ -7973,8 +8130,6 @@ declare type NumericWithFormatter = {
     formatterOptions?: NumericFormatterOptions;
 };
 
-export declare function Ol({ children, ...props }: React.HTMLAttributes<HTMLOListElement>): JSX_2.Element;
-
 export declare type OnAddNewElementParams = {
     type: ElementType;
     afterId?: string;
@@ -8082,8 +8237,6 @@ declare type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
 /** Overflow values */
 export declare type OverflowToken = "visible" | "hidden" | "auto" | "scroll";
 
-export declare function P({ children, ...props }: React.HTMLAttributes<HTMLParagraphElement>): JSX_2.Element;
-
 /**
  * Represents a paginated response with page-based navigation.
  *
@@ -8237,8 +8390,6 @@ declare type PopupSize = "sm" | "md" | "lg";
 /** CSS position */
 export declare type PositionToken = "static" | "relative" | "absolute" | "fixed" | "sticky";
 
-export declare function Pre({ children, ...props }: React.HTMLAttributes<HTMLPreElement>): JSX_2.Element;
-
 export declare const predefinedPresets: Record<string, DatePreset>;
 
 /**
@@ -8590,12 +8741,6 @@ export declare type RecordType = Record<string, unknown>;
 
 declare type ReferenceType = "none" | "striped";
 
-/**
- * Register a canvas entity definition.
- * Called as a side-effect when each entity module is imported.
- */
-export declare function registerCanvasEntity<T extends CanvasContentBase>(definition: CanvasEntityDefinition<T>): void;
-
 declare type RegularAction = BaseAction & {
     type: "regular";
     variant: ButtonVariant;
@@ -8609,6 +8754,59 @@ declare type RelaxedNumericWithFormatter = Omit<NumericWithFormatter, "numericVa
     numericValue: Numeric;
 };
 
+/**
+ * Callback provided to F0Form / F0WizardForm that renders custom fields
+ * identified by `customFieldName` instead of an inline `render` function.
+ *
+ * For `fieldType: "custom"` — return a ReactNode (component) as before.
+ * For `fieldType: "select"` — return either a ReactNode or a `RenderCustomFieldSelectConfig`
+ * with `{ _type: "select-config", source, mapOptions }` to configure the select dynamically.
+ */
+export declare type RenderCustomFieldFunction = (props: RenderCustomFieldProps) => RenderCustomFieldResult;
+
+/**
+ * Props passed to the form-level `renderCustomField` callback.
+ * Extends the base custom field render props with a required `customFieldName`.
+ */
+export declare interface RenderCustomFieldProps extends CustomFieldRenderPropsBase {
+    /** Name identifying this custom field type */
+    customFieldName: string;
+    /** Custom configuration (if provided via fieldConfig) */
+    config: unknown;
+    /** The field type this customFieldName is attached to (e.g. "select", "custom") */
+    fieldType: string;
+}
+
+/**
+ * Return type for the `renderCustomField` callback.
+ * Can return either:
+ * - A React node (rendered directly as a custom component)
+ * - A select config object (merged into the select field props)
+ */
+declare type RenderCustomFieldResult = React.ReactNode | RenderCustomFieldSelectConfig;
+
+/**
+ * Select field configuration that `renderCustomField` can return
+ * for select fields with `customFieldName` (e.g. reusable entity selectors).
+ *
+ * Mirrors the select field config shape — either static `options` or dynamic `source`+`mapOptions`.
+ */
+export declare interface RenderCustomFieldSelectConfig {
+    _type: "select-config";
+    /** Data source for fetching options dynamically */
+    source?: unknown;
+    /** Function to map data source items to select options */
+    mapOptions?: (item: never) => unknown;
+    /** Static options array */
+    options?: unknown[];
+    /** Whether multiple selection is allowed */
+    multiple?: boolean;
+    /** Whether to show the search box */
+    showSearchBox?: boolean;
+    /** Placeholder for the search box */
+    searchBoxPlaceholder?: string;
+}
+
 declare type RendererDefinition = ValueDisplayRendererDefinition;
 
 /**
@@ -8984,8 +9182,6 @@ export declare interface StepItemProps {
     isCompleted?: boolean;
 }
 
-export declare function Strong({ children, ...props }: React.HTMLAttributes<HTMLSpanElement>): JSX_2.Element;
-
 export declare interface SuccessMessageProps {
     title: string;
     description: string;
@@ -9118,8 +9314,6 @@ export declare type SurveySubmitAnswers = Record<string, string | number | strin
  */
 declare type SwitchFieldRenderIf = BooleanRenderIfCondition | CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
 
-export declare function Table({ children, ...props }: React.HTMLAttributes<HTMLTableElement>): JSX_2.Element;
-
 declare type TableCollectionProps<R extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition, ItemActions extends ItemActionsDefinition<R>, NavigationFilters extends NavigationFiltersDefinition, Grouping extends GroupingDefinition<R>> = CollectionProps<R, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping, TableVisualizationOptions<R, Filters, Sortings, Summaries>>;
 
 declare type TableColumnDefinition<R extends RecordType, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition> = WithOptionalSorting<R, Sortings> & Pick<ComponentProps<typeof TableHead>, "hidden" | "info" | "infoIcon" | "sticky" | "width"> & {
@@ -9222,12 +9416,6 @@ declare interface TableHeadProps {
 
 declare type TableOfContentPopoverVariant = "dark" | "light";
 
-/**
- * Table variant without the built-in download button.
- * Used inside components that already provide their own download controls.
- */
-export declare function TableSimple({ children, ...props }: React.HTMLAttributes<HTMLTableElement>): JSX_2.Element;
-
 declare type TableVisualizationOptions<R extends RecordType, _Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition> = {
     /**
      * The columns to display
@@ -9433,8 +9621,6 @@ export declare type TagVariant = BaseTag<{
     type: "raw";
 } & TagRawProps>;
 
-export declare function Td({ children, ...props }: React.HTMLAttributes<HTMLTableCellElement>): JSX_2.Element;
-
 export declare type TeamAvatarVariant = Extract<AvatarVariant, {
     type: "team";
 }>;
@@ -9546,8 +9732,6 @@ declare const textVariants: (props?: ({
     className?: ClassValue;
 })) | undefined) => string;
 
-export declare function Th({ children, ...props }: React.HTMLAttributes<HTMLTableCellElement>): JSX_2.Element;
-
 declare type TOCItem<Depth extends 1 | 2 | 3 | 4 = 1> = BaseTOCItem & {
     children?: NextDepth<Depth> extends never ? never : TOCItem<NextDepth<Depth>>[];
 };
@@ -9624,8 +9808,6 @@ export declare interface TwoColumnLayoutProps {
     sticky?: boolean;
 }
 
-export declare function Ul({ children, ...props }: React.HTMLAttributes<HTMLUListElement>): JSX_2.Element;
-
 /**
  * Unwrap optional, nullable, default wrappers to get the inner schema
  * Uses _def.typeName for reliable type checking across module boundaries
@@ -9890,17 +10072,10 @@ export declare interface UseDataReturn<R extends RecordType> {
 export declare function useDataSource<R extends RecordType = RecordType, FiltersSchema extends FiltersDefinition = FiltersDefinition, Sortings extends SortingsDefinition = SortingsDefinition, Grouping extends GroupingDefinition<R> = GroupingDefinition<R>>({ defaultFilters, currentFilters: externalCurrentFilters, defaultGrouping: externalDefaultGrouping, currentGrouping: externalCurrentGrouping, filters, search, defaultSortings, currentSortings: externalCurrentSortings, dataAdapter, grouping, ...rest }: DataSourceDefinition<R, FiltersSchema, Sortings, Grouping>, deps?: ReadonlyArray<unknown>): DataSource<R, FiltersSchema, Sortings, Grouping>;
 
 /**
- * Hook to register all default copilot actions.
- * This provides a single entry point to enable all standard AI chat actions.
- *
- * @example
- * // Enable all default actions in your component
- * const MyComponent = () => {
- *   useDefaultCopilotActions()
- *   return <div>...</div>
- * }
+ * Hook that invokes every configured copilot action factory.
+ * Actions are declared in the `copilotActions` array in `registry.ts`.
  */
-export declare const useDefaultCopilotActions: () => void;
+export declare function useDefaultCopilotActions(): void;
 
 export declare function useDndEvents(handler: (e: {
     phase: "start" | "over" | "drop" | "cancel";
@@ -9924,6 +10099,12 @@ export declare const useEmojiConfetti: () => {
     fireEmojiConfetti: (emoji: string, elementRef: RefObject<HTMLElement>) => void;
 };
 
+/**
+ * Hook to access the AI form registry.
+ * Returns null if not inside a F0AiFormRegistryProvider.
+ */
+export declare function useF0AiFormRegistry(): F0AiFormRegistryContextValue | null;
+
 export declare const useF0Dialog: () => F0DialogContextType;
 
 /**
@@ -9967,32 +10148,68 @@ export declare const useF0Dialog: () => F0DialogContextType;
  */
 export declare function useF0Form(): UseF0FormReturn;
 
-export declare function useF0FormDefinition<TSchema extends F0FormSchema_2>(input: UseF0FormDefinitionSingleSchemaInput<TSchema>): F0FormDefinitionSingleSchema<TSchema>;
+/** Single schema, no params */
+export declare function useF0FormDefinition<TSchema extends F0FormSchema_2>(input: UseF0FormDefinitionSingleSchemaInputWithoutParams<TSchema>): F0FormDefinitionSingleSchema<TSchema>;
+
+/** Single schema, with params */
+export declare function useF0FormDefinition<TSchema extends F0FormSchema_2, TParams extends Record<string, unknown>>(input: UseF0FormDefinitionSingleSchemaInputWithParams<TSchema, TParams>): F0FormDefinitionSingleSchema<TSchema>;
 
-export declare function useF0FormDefinition<T extends F0PerSectionSchema_2>(input: UseF0FormDefinitionPerSectionInput<T>): F0FormDefinitionPerSection<T>;
+/** Per-section, no params */
+export declare function useF0FormDefinition<T extends F0PerSectionSchema_2>(input: UseF0FormDefinitionPerSectionInputWithoutParams<T>): F0FormDefinitionPerSection<T>;
 
-declare interface UseF0FormDefinitionPerSectionInput<T extends F0PerSectionSchema_2> {
+/** Per-section, with params */
+export declare function useF0FormDefinition<T extends F0PerSectionSchema_2, TParams extends Record<string, unknown>>(input: UseF0FormDefinitionPerSectionInputWithParams<T, TParams>): F0FormDefinitionPerSection<T>;
+
+/** Base fields shared by all per-section input variants */
+declare interface UseF0FormDefinitionPerSectionInputBase<T extends F0PerSectionSchema_2> {
     name: string;
     schema: T;
     sections?: Record<string, F0PerSectionSectionConfig>;
-    defaultValues?: {
-        [K in keyof T]?: Partial<z.infer<T[K]>>;
-    };
     onSubmit: (arg: F0WizardFormPerSectionSubmitArg<T>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
     submitConfig?: F0PerSectionSubmitConfig;
     errorTriggerMode?: F0FormErrorTriggerMode;
 }
 
-declare interface UseF0FormDefinitionSingleSchemaInput<TSchema extends F0FormSchema_2> {
+/** Per-section input WITHOUT `defaultValuesParamsSchema` */
+declare interface UseF0FormDefinitionPerSectionInputWithoutParams<T extends F0PerSectionSchema_2> extends UseF0FormDefinitionPerSectionInputBase<T> {
+    defaultValues?: AsyncOrSync<{
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    }>;
+    defaultValuesParamsSchema?: undefined;
+}
+
+/** Per-section input WITH `defaultValuesParamsSchema` */
+declare interface UseF0FormDefinitionPerSectionInputWithParams<T extends F0PerSectionSchema_2, TParams extends Record<string, unknown>> extends UseF0FormDefinitionPerSectionInputBase<T> {
+    defaultValues?: {
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    } | AsyncWithParams<{
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    }, TParams>;
+    defaultValuesParamsSchema: ZodType<TParams>;
+}
+
+/** Base fields shared by all single-schema input variants */
+declare interface UseF0FormDefinitionSingleSchemaInputBase<TSchema extends F0FormSchema_2> {
     name: string;
     schema: TSchema;
     sections?: Record<string, F0SectionConfig>;
-    defaultValues?: Partial<z.infer<TSchema>>;
     onSubmit: (arg: F0WizardFormSingleSubmitArg<TSchema>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
     submitConfig?: F0FormSubmitConfig;
     errorTriggerMode?: F0FormErrorTriggerMode;
 }
 
+/** Single-schema input WITHOUT `defaultValuesParamsSchema` → `defaultValues` is sync or `(signal) => Promise<T>` */
+declare interface UseF0FormDefinitionSingleSchemaInputWithoutParams<TSchema extends F0FormSchema_2> extends UseF0FormDefinitionSingleSchemaInputBase<TSchema> {
+    defaultValues?: AsyncOrSync<Partial<z.infer<TSchema>>>;
+    defaultValuesParamsSchema?: undefined;
+}
+
+/** Single-schema input WITH `defaultValuesParamsSchema` → `defaultValues` is sync or `(params) => Promise<T>` */
+declare interface UseF0FormDefinitionSingleSchemaInputWithParams<TSchema extends F0FormSchema_2, TParams extends Record<string, unknown>> extends UseF0FormDefinitionSingleSchemaInputBase<TSchema> {
+    defaultValues?: Partial<z.infer<TSchema>> | AsyncWithParams<Partial<z.infer<TSchema>>, TParams>;
+    defaultValuesParamsSchema: ZodType<TParams>;
+}
+
 /**
  * Return type for the useF0Form hook
  */
@@ -10019,6 +10236,27 @@ export declare interface UseF0FormReturn {
      * Get the current form values (including unsaved changes)
      */
     getValues: () => Record<string, unknown>;
+    /**
+     * Set a single field value programmatically
+     */
+    setValue: (fieldName: string, value: unknown, options?: F0FormSetValueOptions) => void;
+    /**
+     * Set multiple field values at once
+     */
+    setValues: (values: Record<string, unknown>, options?: F0FormSetValueOptions) => void;
+    /**
+     * Manually trigger validation for a specific field or all fields
+     * @returns true if validation passes
+     */
+    trigger: (fieldName?: string) => Promise<boolean>;
+    /**
+     * Get current validation errors as a map of field name to error message
+     */
+    getErrors: () => Record<string, string>;
+    /**
+     * Get the list of field names in the form
+     */
+    getFieldNames: () => string[];
     /**
      * Whether the form is currently submitting
      */