pxengine 0.1.46 → 0.1.48

package/dist/index.d.cts

@@ -1953,6 +1953,11 @@ interface CampaignSeedCardProps extends Omit<FormCardProps, "fields"> {
      * Optional action handler
      */
     onAction?: (action: any) => void;
+    /**
+     * Optional callback to send a message to the agent directly.
+     * When provided, the proceed button calls this instead of relying on onAction.
+     */
+    sendMessage?: (text: string) => void;
 }
 
 /**
@@ -1993,6 +1998,11 @@ interface SearchSpecCardProps extends Omit<FormCardProps, "fields"> {
      * Optional action handler
      */
     onAction?: (action: any) => void;
+    /**
+     * Optional callback to send a message to the agent directly.
+     * When provided, the proceed button calls this instead of relying on onAction.
+     */
+    sendMessage?: (text: string) => void;
 }
 
 /**
@@ -2079,18 +2089,47 @@ interface MCQCardProps {
      * Whether the interaction is disabled externally
      */
     disabled?: boolean;
+    /**
+     * Session ID for self-contained persistence.
+     * When provided with sendMessage, MCQCard handles its own state.
+     */
+    sessionId?: string;
+    /**
+     * Callback to send a message to the agent.
+     * Called after user confirms selection.
+     */
+    sendMessage?: (text: string) => void;
+    /**
+     * Custom fetcher for loading existing selections.
+     * Defaults to hitting /api/agents-proxy/custom-agents/sessions/{sessionId}/mcq-selections/get
+     */
+    fetchSelections?: (sessionId: string) => Promise<Record<string, string>>;
+    /**
+     * Custom fetcher for persisting a selection.
+     * Defaults to hitting /api/agents-proxy/custom-agents/sessions/{sessionId}/mcq-selections
+     */
+    persistSelection?: (sessionId: string, questionKey: string, value: string) => Promise<void>;
 }
 
 /**
  * MCQCard
  *
  * A molecule for Multiple Choice Questions.
- * Styled to match OptionsRenderer from creator-engine
+ * Self-contained: when `sessionId` + `sendMessage` are provided,
+ * it manages its own persistence and agent communication.
  */
 declare const MCQCard: React__default.NamedExoticComponent<MCQCardProps & {
     disableContinueInDiscovery?: boolean;
 }>;
 
+/**
+ * Default fetchers for MCQCard self-contained mode.
+ * These hit relative API URLs via the agents-proxy, matching the
+ * endpoints in server/api/custom_agents/state.py.
+ */
+declare function defaultFetchSelections(sessionId: string): Promise<Record<string, string>>;
+declare function defaultPersistSelection(sessionId: string, questionKey: string, value: string): Promise<void>;
+
 /**
  * PlatformIconGroup
  * Displays a horizontal list of active social platform icons.
@@ -2265,14 +2304,24 @@ interface FetchStatusParams {
     sessionId: string;
     versionNo: number;
 }
+interface FetchCreatorDetailsParams {
+    creatorIds: number[];
+    sessionId: string;
+    versionNo?: number;
+}
+interface CreatorDetailData {
+    success: boolean;
+    creatorData: any[];
+}
 interface CreatorWidgetProps {
     sessionId: string;
     currentVersion?: number;
     isAgentOutput?: boolean;
-    fetchVersions: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
-    fetchStatus: (params: FetchStatusParams) => Promise<{
+    fetchVersions?: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
+    fetchStatus?: (params: FetchStatusParams) => Promise<{
         status: StatusDetails;
     }>;
+    fetchCreatorDetails?: (params: FetchCreatorDetailsParams) => Promise<CreatorDetailData>;
     pollingConfig?: PollingConfig;
     onStatusChange?: (status: CreatorWidgetStatus) => void;
     onAction?: (action: CreatorWidgetAction) => void;
@@ -2309,22 +2358,33 @@ interface CreatorProgressBarProps {
     timeRemaining?: string;
 }
 
-declare function CreatorWidgetInner({ sessionId, currentVersion, isAgentOutput, fetchVersions, fetchStatus, pollingConfig, onStatusChange, onAction, className, }: CreatorWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CreatorWidgetInner({ sessionId, currentVersion, isAgentOutput, fetchVersions, fetchStatus, fetchCreatorDetails, pollingConfig, onStatusChange, onAction, className, }: CreatorWidgetProps): react_jsx_runtime.JSX.Element;
 declare const CreatorWidget: React$1.MemoExoticComponent<typeof CreatorWidgetInner>;
 
 declare function CreatorWidgetSkeleton(): react_jsx_runtime.JSX.Element;
 
+interface CreatorExpandedPanelProps {
+    isOpen: boolean;
+    onClose: () => void;
+    sessionId: string;
+    creatorIds: number[];
+    version?: number;
+    searchSpec: Record<string, any>;
+    fetchCreatorDetails?: (params: FetchCreatorDetailsParams) => Promise<CreatorDetailData>;
+}
+declare function CreatorExpandedPanel({ isOpen, onClose, sessionId, creatorIds, version, searchSpec, fetchCreatorDetails, }: CreatorExpandedPanelProps): React$1.ReactPortal | null;
+
 interface UseCreatorWidgetPollingParams {
     sessionId: string;
     currentVersion?: number;
-    fetchVersions: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
-    fetchStatus: (params: FetchStatusParams) => Promise<{
+    fetchVersions?: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
+    fetchStatus?: (params: FetchStatusParams) => Promise<{
         status: StatusDetails;
     }>;
     pollingConfig?: PollingConfig;
     onStatusChange?: (status: CreatorWidgetStatus) => void;
 }
-declare function useCreatorWidgetPolling({ sessionId, currentVersion, fetchVersions, fetchStatus, pollingConfig, onStatusChange, }: UseCreatorWidgetPollingParams): {
+declare function useCreatorWidgetPolling({ sessionId, currentVersion, fetchVersions: fetchVersionsProp, fetchStatus: fetchStatusProp, pollingConfig, onStatusChange, }: UseCreatorWidgetPollingParams): {
     versionData: CreatorVersionData | null;
     versionNumbers: number[];
     selectedVersion: number | undefined;
@@ -2441,4 +2501,4 @@ interface StageIndicatorProps extends Omit<StageIndicatorMolecule, "id" | "type"
  */
 declare const StageIndicator: React__default.FC<StageIndicatorProps>;
 
-export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, AgentCard, type AgentCardMolecule, AgentDataTable, type AgentDataTableMolecule, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, InstructionPreview, type InstructionPreviewMolecule, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, MultiAgentCard, type MultiAgentCardMolecule, MultiAgentPlan, type MultiAgentPlanMolecule, MultiAgentUISelector, type MultiAgentUISelectorMolecule, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, Spinner, SpinnerAtom, type SpinnerAtomType, StageIndicator, type StageIndicatorMolecule, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, ToolListCard, type ToolListCardMolecule, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, UIComponentSelector, type UIComponentSelectorMolecule, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, WorkflowVisualizer, type WorkflowVisualizerMolecule, cn, generateFieldsFromData, generateFieldsFromPropDefinitions, useCreatorWidgetPolling };
+export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, AgentCard, type AgentCardMolecule, AgentDataTable, type AgentDataTableMolecule, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, type CreatorDetailData, CreatorExpandedPanel, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchCreatorDetailsParams, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, InstructionPreview, type InstructionPreviewMolecule, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, MultiAgentCard, type MultiAgentCardMolecule, MultiAgentPlan, type MultiAgentPlanMolecule, MultiAgentUISelector, type MultiAgentUISelectorMolecule, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, Spinner, SpinnerAtom, type SpinnerAtomType, StageIndicator, type StageIndicatorMolecule, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, ToolListCard, type ToolListCardMolecule, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, UIComponentSelector, type UIComponentSelectorMolecule, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, WorkflowVisualizer, type WorkflowVisualizerMolecule, cn, defaultFetchSelections, defaultPersistSelection, generateFieldsFromData, generateFieldsFromPropDefinitions, useCreatorWidgetPolling };

package/dist/index.d.ts

@@ -1953,6 +1953,11 @@ interface CampaignSeedCardProps extends Omit<FormCardProps, "fields"> {
      * Optional action handler
      */
     onAction?: (action: any) => void;
+    /**
+     * Optional callback to send a message to the agent directly.
+     * When provided, the proceed button calls this instead of relying on onAction.
+     */
+    sendMessage?: (text: string) => void;
 }
 
 /**
@@ -1993,6 +1998,11 @@ interface SearchSpecCardProps extends Omit<FormCardProps, "fields"> {
      * Optional action handler
      */
     onAction?: (action: any) => void;
+    /**
+     * Optional callback to send a message to the agent directly.
+     * When provided, the proceed button calls this instead of relying on onAction.
+     */
+    sendMessage?: (text: string) => void;
 }
 
 /**
@@ -2079,18 +2089,47 @@ interface MCQCardProps {
      * Whether the interaction is disabled externally
      */
     disabled?: boolean;
+    /**
+     * Session ID for self-contained persistence.
+     * When provided with sendMessage, MCQCard handles its own state.
+     */
+    sessionId?: string;
+    /**
+     * Callback to send a message to the agent.
+     * Called after user confirms selection.
+     */
+    sendMessage?: (text: string) => void;
+    /**
+     * Custom fetcher for loading existing selections.
+     * Defaults to hitting /api/agents-proxy/custom-agents/sessions/{sessionId}/mcq-selections/get
+     */
+    fetchSelections?: (sessionId: string) => Promise<Record<string, string>>;
+    /**
+     * Custom fetcher for persisting a selection.
+     * Defaults to hitting /api/agents-proxy/custom-agents/sessions/{sessionId}/mcq-selections
+     */
+    persistSelection?: (sessionId: string, questionKey: string, value: string) => Promise<void>;
 }
 
 /**
  * MCQCard
  *
  * A molecule for Multiple Choice Questions.
- * Styled to match OptionsRenderer from creator-engine
+ * Self-contained: when `sessionId` + `sendMessage` are provided,
+ * it manages its own persistence and agent communication.
  */
 declare const MCQCard: React__default.NamedExoticComponent<MCQCardProps & {
     disableContinueInDiscovery?: boolean;
 }>;
 
+/**
+ * Default fetchers for MCQCard self-contained mode.
+ * These hit relative API URLs via the agents-proxy, matching the
+ * endpoints in server/api/custom_agents/state.py.
+ */
+declare function defaultFetchSelections(sessionId: string): Promise<Record<string, string>>;
+declare function defaultPersistSelection(sessionId: string, questionKey: string, value: string): Promise<void>;
+
 /**
  * PlatformIconGroup
  * Displays a horizontal list of active social platform icons.
@@ -2265,14 +2304,24 @@ interface FetchStatusParams {
     sessionId: string;
     versionNo: number;
 }
+interface FetchCreatorDetailsParams {
+    creatorIds: number[];
+    sessionId: string;
+    versionNo?: number;
+}
+interface CreatorDetailData {
+    success: boolean;
+    creatorData: any[];
+}
 interface CreatorWidgetProps {
     sessionId: string;
     currentVersion?: number;
     isAgentOutput?: boolean;
-    fetchVersions: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
-    fetchStatus: (params: FetchStatusParams) => Promise<{
+    fetchVersions?: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
+    fetchStatus?: (params: FetchStatusParams) => Promise<{
         status: StatusDetails;
     }>;
+    fetchCreatorDetails?: (params: FetchCreatorDetailsParams) => Promise<CreatorDetailData>;
     pollingConfig?: PollingConfig;
     onStatusChange?: (status: CreatorWidgetStatus) => void;
     onAction?: (action: CreatorWidgetAction) => void;
@@ -2309,22 +2358,33 @@ interface CreatorProgressBarProps {
     timeRemaining?: string;
 }
 
-declare function CreatorWidgetInner({ sessionId, currentVersion, isAgentOutput, fetchVersions, fetchStatus, pollingConfig, onStatusChange, onAction, className, }: CreatorWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CreatorWidgetInner({ sessionId, currentVersion, isAgentOutput, fetchVersions, fetchStatus, fetchCreatorDetails, pollingConfig, onStatusChange, onAction, className, }: CreatorWidgetProps): react_jsx_runtime.JSX.Element;
 declare const CreatorWidget: React$1.MemoExoticComponent<typeof CreatorWidgetInner>;
 
 declare function CreatorWidgetSkeleton(): react_jsx_runtime.JSX.Element;
 
+interface CreatorExpandedPanelProps {
+    isOpen: boolean;
+    onClose: () => void;
+    sessionId: string;
+    creatorIds: number[];
+    version?: number;
+    searchSpec: Record<string, any>;
+    fetchCreatorDetails?: (params: FetchCreatorDetailsParams) => Promise<CreatorDetailData>;
+}
+declare function CreatorExpandedPanel({ isOpen, onClose, sessionId, creatorIds, version, searchSpec, fetchCreatorDetails, }: CreatorExpandedPanelProps): React$1.ReactPortal | null;
+
 interface UseCreatorWidgetPollingParams {
     sessionId: string;
     currentVersion?: number;
-    fetchVersions: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
-    fetchStatus: (params: FetchStatusParams) => Promise<{
+    fetchVersions?: (params: FetchVersionsParams) => Promise<CreatorVersionData>;
+    fetchStatus?: (params: FetchStatusParams) => Promise<{
         status: StatusDetails;
     }>;
     pollingConfig?: PollingConfig;
     onStatusChange?: (status: CreatorWidgetStatus) => void;
 }
-declare function useCreatorWidgetPolling({ sessionId, currentVersion, fetchVersions, fetchStatus, pollingConfig, onStatusChange, }: UseCreatorWidgetPollingParams): {
+declare function useCreatorWidgetPolling({ sessionId, currentVersion, fetchVersions: fetchVersionsProp, fetchStatus: fetchStatusProp, pollingConfig, onStatusChange, }: UseCreatorWidgetPollingParams): {
     versionData: CreatorVersionData | null;
     versionNumbers: number[];
     selectedVersion: number | undefined;
@@ -2441,4 +2501,4 @@ interface StageIndicatorProps extends Omit<StageIndicatorMolecule, "id" | "type"
  */
 declare const StageIndicator: React__default.FC<StageIndicatorProps>;
 
-export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, AgentCard, type AgentCardMolecule, AgentDataTable, type AgentDataTableMolecule, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, InstructionPreview, type InstructionPreviewMolecule, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, MultiAgentCard, type MultiAgentCardMolecule, MultiAgentPlan, type MultiAgentPlanMolecule, MultiAgentUISelector, type MultiAgentUISelectorMolecule, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, Spinner, SpinnerAtom, type SpinnerAtomType, StageIndicator, type StageIndicatorMolecule, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, ToolListCard, type ToolListCardMolecule, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, UIComponentSelector, type UIComponentSelectorMolecule, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, WorkflowVisualizer, type WorkflowVisualizerMolecule, cn, generateFieldsFromData, generateFieldsFromPropDefinitions, useCreatorWidgetPolling };
+export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, AgentCard, type AgentCardMolecule, AgentDataTable, type AgentDataTableMolecule, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, type CreatorDetailData, CreatorExpandedPanel, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchCreatorDetailsParams, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, InstructionPreview, type InstructionPreviewMolecule, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, MultiAgentCard, type MultiAgentCardMolecule, MultiAgentPlan, type MultiAgentPlanMolecule, MultiAgentUISelector, type MultiAgentUISelectorMolecule, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, Spinner, SpinnerAtom, type SpinnerAtomType, StageIndicator, type StageIndicatorMolecule, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, ToolListCard, type ToolListCardMolecule, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, UIComponentSelector, type UIComponentSelectorMolecule, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, WorkflowVisualizer, type WorkflowVisualizerMolecule, cn, defaultFetchSelections, defaultPersistSelection, generateFieldsFromData, generateFieldsFromPropDefinitions, useCreatorWidgetPolling };