@factorialco/f0-react 1.482.0 → 2.0.0

package/dist/f0.d.ts

@@ -531,6 +531,14 @@ export declare type AiChatProviderProps = {
      * Provides save/create functions for persisting canvas entities externally.
      */
     canvasActions?: CanvasActions;
+    /**
+     * Canvas entity definitions keyed by `CanvasContent["type"]`. The canvas
+     * panel looks up the matching definition when `openCanvas` is called.
+     *
+     * F0AiChat ships without built-in canvas entities; the host app supplies
+     * 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.
@@ -729,7 +737,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" | "toolHints" | "credits" | "creditWarning" | "fileAttachments"> & {
+} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "canvasActions" | "canvasEntities" | "toolHints" | "credits" | "creditWarning" | "fileAttachments"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
     /** Open the canvas panel with the given content */
@@ -766,6 +774,7 @@ declare interface AiChatState {
     VoiceMode?: React.ComponentType;
     entityRefs?: EntityRefs;
     canvasActions?: CanvasActions;
+    canvasEntities?: Record<string, CanvasEntityDefinition>;
     toolHints?: AiChatToolHint[];
     credits?: AiChatCredits;
     creditWarning?: AiChatCreditWarning;
@@ -1548,6 +1557,15 @@ export declare type BigNumberProps = {
     comparison: Numeric | NumberWithFormatter | number;
 };
 
+/**
+ * Person avatar data for the expert list
+ */
+export declare interface BookAMeetingCardAvatar {
+    firstName: string;
+    lastName: string;
+    src?: string;
+}
+
 /**
  * Base for boolean-specific conditions
  */
@@ -1885,6 +1903,36 @@ 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.
@@ -2393,7 +2441,7 @@ declare interface ChatDashboardColumn {
  * Contains fetchSpecs that describe how to obtain data server-side —
  * no raw data is included. Fully JSON-serializable.
  */
-declare interface ChatDashboardConfig {
+export declare interface ChatDashboardConfig {
     /** Dashboard title displayed in the canvas header and chat report card */
     title: string;
     /**
@@ -2703,7 +2751,7 @@ declare interface ClarifyingOption {
  * Navigation metadata (currentStepIndex, totalSteps) and callbacks live
  * here so the panel component stays a pure view of this state.
  */
-declare interface ClarifyingQuestionState {
+export declare interface ClarifyingQuestionState {
     /** The current step's data + interaction state */
     currentStep: ClarifyingStepState;
     /** Zero-based index of the current step */
@@ -2737,13 +2785,13 @@ declare interface ClarifyingQuestionState {
  * - "single": only one option can be selected (rendered as radio buttons)
  * - "multiple": multiple options can be selected (rendered as checkboxes)
  */
-declare type ClarifyingSelectionMode = "single" | "multiple";
+export declare type ClarifyingSelectionMode = "single" | "multiple";
 
 /**
  * Pure data describing a single clarifying question step.
  * This is what the AI backend sends — no UI state or callbacks.
  */
-declare interface ClarifyingStepData {
+export declare interface ClarifyingStepData {
     /** The question text displayed to the user */
     question: string;
     /** Available options the user can select from */
@@ -2769,6 +2817,10 @@ declare interface ClarifyingStepState extends ClarifyingStepData {
     isCustomAnswerActive: boolean;
 }
 
+export declare function CloseCanvasButton({ onClick }: {
+    onClick: () => void;
+}): JSX_2.Element;
+
 declare type ColId = string;
 
 declare interface CollectionComputation {
@@ -3102,7 +3154,7 @@ export declare const Dashboard: WithDataTestIdReturnType_3<ComponentType<Dashboa
 /**
  * Callbacks for persisting dashboards externally (beyond chat history).
  */
-declare type DashboardCanvasActions = {
+export declare type DashboardCanvasActions = {
     /** Update an existing saved dashboard */
     save: (id: string, category: string, config: ChatDashboardConfig) => Promise<void>;
     /**
@@ -3145,6 +3197,45 @@ 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;
+};
+
 /**
  * Chart display configuration — discriminated on `type`.
  * This object is JSON-serializable (no functions, except optional formatters).
@@ -3206,6 +3297,11 @@ export declare interface DashboardCollectionItem<Filters extends FiltersDefiniti
     visualizations: ReadonlyArray<any>;
 }
 
+export declare function DashboardContent({ content, refreshKey: _parentRefreshKey, }: {
+    content: DashboardCanvasContent;
+    refreshKey: number;
+}): ReactNode;
+
 declare interface DashboardFetchSpec {
     fetch: Array<{
         toolId: string;
@@ -3215,6 +3311,18 @@ 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;
+
 /**
  * A single dashboard item. Discriminated on `type`.
  *
@@ -3500,18 +3608,36 @@ export declare type DataCollectionStorageHandler<CurrentFiltersState extends Fil
 /**
  * Data download canvas content — renders a full data table with download options.
  */
-declare type DataDownloadCanvasContent = CanvasContentBase & {
+export declare type DataDownloadCanvasContent = CanvasContentBase & {
     type: "dataDownload";
     dataset: DataDownloadDataset;
     filename?: string;
     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.
  */
-declare type DataDownloadDataset = {
+export declare type DataDownloadDataset = {
     /**
      * Column headers in display order.
      */
@@ -3537,6 +3663,16 @@ 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;
+
 /**
  * Represents an error that occurred during data fetching
  */
@@ -5187,7 +5323,7 @@ export declare const F0AiChat: () => JSX_2.Element | null;
 /**
  * @experimental This is an experimental component use it at your own risk
  */
-export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, canvasActions, toolHints, credits, creditWarning, fileAttachments, onThumbsUp, onThumbsDown, onBeforeSendMessage, runtimeFetch, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, canvasActions, canvasEntities, toolHints, credits, creditWarning, fileAttachments, onThumbsUp, onThumbsDown, onBeforeSendMessage, runtimeFetch, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
 
 export declare const F0AiChatTextArea: ({ submitLabel, inProgress, onSend, onStop, creditWarning, }: ChatTextareaProps) => JSX_2.Element;
 
@@ -5837,6 +5973,22 @@ displayName: string;
 Skeleton: () => JSX_2.Element;
 }>;
 
+export declare const F0BookAMeetingCard: ({ onAction, actionHref, }: F0BookAMeetingCardProps) => JSX_2.Element;
+
+/**
+ * Props for the F0BookAMeetingCard component
+ */
+export declare interface F0BookAMeetingCardProps {
+    /**
+     * Callback when the action button is clicked. Omit when using actionHref.
+     */
+    onAction?: () => void;
+    /**
+     * When set, the action button renders as a link to this URL.
+     */
+    actionHref?: string;
+}
+
 /**
  * Config for boolean fields - checkbox
  */
@@ -6747,6 +6899,34 @@ export declare type F0DateTimeFieldConfig = F0BaseConfig & F0DateTimeConfig & {
     fieldType: "datetime";
 };
 
+export declare const F0DemoCard: ({ preview, moduleName, description, onAction, actionHref, }: F0DemoCardProps) => JSX_2.Element;
+
+/**
+ * Props for the F0DemoCard component
+ */
+export declare interface F0DemoCardProps {
+    /**
+     * Content for the preview area (embedded app preview, image, or custom content)
+     */
+    preview: ReactNode;
+    /**
+     * Main title below the preview (e.g. "See Projects in action")
+     */
+    moduleName: string;
+    /**
+     * Description text below the title
+     */
+    description: string;
+    /**
+     * Callback when the action button is clicked. Omit when using actionHref.
+     */
+    onAction?: () => void;
+    /**
+     * When set, the action button renders as a link to this URL (e.g. for copilot-driven cards).
+     */
+    actionHref?: string;
+}
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -6869,6 +7049,52 @@ export declare interface F0DurationInputProps {
 
 export declare function F0EventCatcherProvider({ children, onEvent, enabled, catchEvents, }: EventCatcherProviderProps): JSX.Element;
 
+export declare const F0FAQCard: ({ headerIcon, items, defaultExpandedId, expandedId: controlledExpandedId, onExpandedChange, allowMultiple, }: F0FAQCardProps) => JSX_2.Element | null;
+
+/**
+ * Props for the F0FAQCard component
+ */
+export declare interface F0FAQCardProps {
+    /**
+     * Optional icon shown in the card header
+     * @default Question icon
+     */
+    headerIcon?: IconType;
+    /**
+     * Array of FAQ items to display
+     */
+    items: F0FAQItem[];
+    /**
+     * Initially expanded item ID (uncontrolled mode)
+     */
+    defaultExpandedId?: string;
+    /**
+     * Currently expanded item ID (controlled mode)
+     */
+    expandedId?: string;
+    /**
+     * Callback when an item is expanded/collapsed (controlled mode)
+     */
+    onExpandedChange?: (id: string | null) => void;
+    /**
+     * Whether multiple items can be expanded at once
+     * @default false
+     */
+    allowMultiple?: boolean;
+}
+
+/**
+ * A single FAQ item with question and answer
+ */
+export declare interface F0FAQItem {
+    /** Unique identifier for the FAQ item */
+    id: string;
+    /** The question text */
+    question: string;
+    /** The answer text */
+    answer: string;
+}
+
 /**
  * Union of all F0 field types used for rendering
  */
@@ -7974,6 +8200,53 @@ export declare type F0LinkProps = Omit<ActionLinkProps, "variant" | "href"> & {
     href?: string;
 };
 
+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 F0ModuleCard: ({ moduleName, description, onAction, actionHref, imageSrc, }: F0ModuleCardProps) => JSX_2.Element;
+
+/**
+ * Props for the F0ModuleCard component
+ */
+export declare interface F0ModuleCardProps {
+    /**
+     * Card title (e.g. "Projects")
+     */
+    moduleName: string;
+    /**
+     * Description text below the title
+     */
+    description: string;
+    /**
+     * Callback when the action button is clicked. Omit when using actionHref.
+     */
+    onAction?: () => void;
+    /**
+     * When set, the action button renders as a link to this URL.
+     */
+    actionHref?: string;
+    /**
+     * Optional image source for the avatar
+     */
+    imageSrc?: string;
+}
+
 /**
  * Configuration for a "more info" link displayed below the help text.
  */
@@ -8167,6 +8440,110 @@ export declare const F0Provider: React.FC<{
     formComponent?: F0FormLikeComponent;
 }>;
 
+export declare const F0QuestionCardMultiStep: ({ steps, onComplete, onSkip, sendAsMessage, onSendMessage, }: F0QuestionCardMultiStepProps) => JSX_2.Element | null;
+
+/**
+ * Props for the F0QuestionCardMultiStep component
+ */
+export declare interface F0QuestionCardMultiStepProps {
+    /** Steps: each has question and options */
+    steps: F0QuestionCardStep[];
+    /** Called when user completes the last step with all selections (step index -> selected option ids) */
+    onComplete?: (selections: Record<number, string[]>) => void;
+    /** Called when user clicks Skip */
+    onSkip?: () => void;
+    /** When true, on last step Next sends selected labels via onSendMessage */
+    sendAsMessage?: boolean;
+    /** Called with joined selected labels when completing with sendAsMessage */
+    onSendMessage?: (message: string) => void;
+    /** Label for the Next button on the last step */
+    nextLabel?: string;
+    /** Label for the Skip button */
+    skipLabel?: string;
+}
+
+/**
+ * Option for the question (checkbox with label)
+ */
+export declare interface F0QuestionCardOption {
+    id: string;
+    label: string;
+}
+
+/**
+ * Props for the F0QuestionCard component (single-step, legacy)
+ */
+export declare interface F0QuestionCardProps {
+    /**
+     * Optional icon in the card header (used when title is set)
+     */
+    headerIcon?: IconType;
+    /**
+     * The question text shown above the options
+     */
+    question: string;
+    /**
+     * Checkbox options (id, label). User can select one or more.
+     */
+    options: F0QuestionCardOption[];
+    /**
+     * Selected option ids (controlled). Omit for uncontrolled.
+     */
+    selectedOptionIds?: string[];
+    /**
+     * Callback when selection changes (controlled)
+     */
+    onSelectionChange?: (selectedIds: string[]) => void;
+    /**
+     * Current step (1-based) for pagination display, e.g. "1/n"
+     */
+    currentStep?: number;
+    /**
+     * Total number of steps for pagination display
+     */
+    totalSteps?: number;
+    /**
+     * Callback when the previous (left arrow) pagination control is clicked
+     */
+    onPrev?: () => void;
+    /**
+     * Callback when Next button is clicked (primary action)
+     */
+    onNext: () => void;
+    /**
+     * Callback when Skip button is clicked
+     */
+    onSkip?: () => void;
+    /**
+     * When true, calling Next will invoke onNextWithSelection with the selected option labels
+     * so the parent can send them as a new user message (e.g. to trigger a new workflow turn).
+     */
+    sendAsMessage?: boolean;
+    /**
+     * Called when user clicks Next and sendAsMessage is true. Receives the selected option labels;
+     * the parent should send this as a new user chat message to trigger the next workflow turn.
+     */
+    onNextWithSelection?: (selectedLabels: string[]) => void;
+    /**
+     * Label for the Next button
+     * @default "Next"
+     */
+    nextLabel?: string;
+    /**
+     * Label for the Skip button
+     * @default "Skip"
+     */
+    skipLabel?: string;
+}
+
+/**
+ * One step in a multi-step question card
+ */
+export declare interface F0QuestionCardStep {
+    question: string;
+    options: F0QuestionCardOption[];
+}
+
 /**
  * F0 config options specific to rich text fields
  */
@@ -8869,6 +9246,12 @@ export declare interface F0ZodType<T extends ZodTypeAny = ZodTypeAny> {
 
 /* Excluded from this release type: FieldItem */
 
+declare type FieldMeta = {
+    label: string;
+    fieldType?: string;
+    customFieldName?: string;
+};
+
 export declare function fieldsToSeconds(fields: DurationFields): number;
 
 /**
@@ -9190,13 +9573,52 @@ declare type FormatPreset = {
 /**
  * Form canvas content — renders an interactive F0Form in the canvas panel.
  */
-declare type FormCanvasContent = CanvasContentBase & {
+export declare type FormCanvasContent = CanvasContentBase & {
     type: "form";
     formName: string;
     formDescription?: string;
     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;
@@ -9214,6 +9636,17 @@ 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;
+}
+
 /* Excluded from this release type: FormDefinitionItem */
 
 /**
@@ -9253,6 +9686,13 @@ export declare interface FormFieldProps {
     ref?: React.RefCallback<HTMLElement>;
 }
 
+export declare function FormHeader({ title, description, module, onClose, }: {
+    title: string;
+    description?: string;
+    module?: ModuleId;
+    onClose: () => void;
+}): JSX_2.Element;
+
 /** 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";
 
@@ -9372,12 +9812,6 @@ export declare const getAnimationVariants: (options?: AnimationVariantsOptions)
     };
 };
 
-/**
- * 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;
-
 /**
  * Get the pagination type of a data adapter
  * @param dataAdapter - The data adapter to get the pagination type of
@@ -10098,6 +10532,16 @@ export declare const linkVariants: readonly ["link", "unstyled", "mention"];
  */
 declare type ListCollectionProps<Record extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition, ItemActions extends ItemActionsDefinition<Record>, NavigationFilters extends NavigationFiltersDefinition, Grouping extends GroupingDefinition<Record>> = CollectionProps<Record, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping, ListVisualizationOptions<Record, Filters, Sortings>>;
 
+/**
+ * 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;
+
 declare type ListPropertyDefinition<R, Sortings extends SortingsDefinition> = WithOptionalSorting_2<R, Sortings> & PropertyDefinition_2<R>;
 
 declare type ListVisualizationOptions<R extends RecordType, _Filters extends FiltersDefinition, Sortings extends SortingsDefinition> = {
@@ -10207,6 +10651,18 @@ export declare interface Message {
     dateTime: string;
 }
 
+export declare const MessageSources: ({ sources }: MessageSourcesProps) => JSX_2.Element | null;
+
+/**
+ * Props for the F0MessageSources component
+ */
+export declare type MessageSourcesProps = {
+    /**
+     * Array of sources to display
+     */
+    sources: Source[];
+};
+
 declare type MetadataAction = {
     icon: IconType;
     label: string;
@@ -10967,6 +11423,10 @@ export declare type OnSelectItemsCallback<R extends RecordType, Filters extends
 
 declare type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
 
+export declare type OrchestratorThinkingResult = {
+    inGroup?: boolean;
+};
+
 /** Overflow values */
 export declare type OverflowToken = "visible" | "hidden" | "auto" | "scroll";
 
@@ -11658,6 +12118,27 @@ export declare type RequisitionProfile = {
 
 export declare type ResolvedRecordType<R> = R extends RecordType ? R : RecordType;
 
+/**
+ * Snapshot of a resolved step's answer — persisted alongside the tool args
+ * so the render can restore state without re-invoking the panel.
+ */
+export declare interface ResolvedStepAnswer {
+    /** The question text (matches the source step) */
+    question: string;
+    /** Selected option IDs at submit time */
+    selectedOptionIds: string[];
+    /** Custom free-text answer if provided */
+    customAnswer?: string;
+    /** True when the user explicitly skipped an optional step */
+    skipped?: boolean;
+    /**
+     * True when the user cancelled the flow before reaching this step.
+     * The step was therefore neither answered nor intentionally skipped —
+     * callers (e.g. the agent) should treat this as "no information".
+     */
+    cancelled?: boolean;
+}
+
 declare type ResourceHeaderProps = Props_4;
 
 /** All styling props that can be overridden per breakpoint */
@@ -11803,6 +12284,13 @@ export declare type RowSpanToken = "1" | "2" | "3" | "4" | "5" | "6" | "full";
 /** Grid row count (1–6 + none) */
 export declare type RowsToken = "1" | "2" | "3" | "4" | "5" | "6" | "none";
 
+export declare const savedDashboardConfigStore: {
+    get(toolCallId: string): ChatDashboardConfig | undefined;
+    set(toolCallId: string, config: ChatDashboardConfig): void;
+    subscribe(listener: Listener): () => void;
+    getSnapshot(): number;
+};
+
 export declare type SearchFilterDefinition = BaseFilterDefinition<"search">;
 
 declare type SearchOptions = {
@@ -12069,6 +12557,28 @@ export declare type SortingsStateMultiple = {
 
 export declare type SortOrder = "asc" | "desc";
 
+/**
+ * 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;
+};
+
 /**
  * Token types for F0Box props.
  * These map to the design tokens defined in @factorialco/f0-core.
@@ -12993,6 +13503,13 @@ export declare function useAiChat(): AiChatProviderReturnValue;
 
 export declare function useAiChatTranslations(): AiChatTranslations;
 
+/**
+ * Hook returning the canvas entity definition for `type` from the registry
+ * supplied to `F0AiChatProvider.canvasEntities`. Returns `undefined` when no
+ * matching entity is configured.
+ */
+export declare function useCanvasEntity(type: string | undefined): CanvasEntityDefinition<any> | undefined;
+
 /**
  * A core React hook that manages data fetching, state management, and pagination within the Collections ecosystem.
  *
@@ -13141,12 +13658,6 @@ 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 that invokes every configured copilot action factory.
- * Actions are declared in the `copilotActions` array in `registry.ts`.
- */
-export declare function useDefaultCopilotActions(): void;
-
 export declare function useDndEvents(handler: (e: {
     phase: "start" | "over" | "drop" | "cancel";
     source: DragPayload;
@@ -13395,18 +13906,6 @@ export declare const useGroups: <R extends RecordType>(groups: GroupRecord<R>[],
     setGroupOpen: (key: string, open: boolean) => void;
 };
 
-/**
- * Hook to register the message sources action.
- * Attaches information sources to the assistant's response to show where the AI got its information from.
- */
-export declare const useMessageSourcesAction: () => void;
-
-/**
- * Hook to register the orchestrator thinking action.
- * Displays the orchestrator's thinking process as a non-blocking UI element.
- */
-export declare const useOrchestratorThinkingAction: () => void;
-
 export declare const usePrivacyMode: () => {
     enabled: boolean;
     enable: () => void;
@@ -13575,6 +14074,9 @@ export declare type UseSelectableReturn<R extends RecordType, Filters extends Fi
  */
 export declare function useSetFormCardValueFormatter(): SetFormCardValueFormatter;
 
+/** Read the tool call ID injected by AssistantMessage. */
+export declare const useToolCallId: () => string | undefined;
+
 export declare const useXRay: () => {
     enabled: boolean;
     filter: ComponentTypes[];
@@ -13802,11 +14304,6 @@ declare module "gridstack" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -13854,3 +14351,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}