Reference
Primitives Reference
40 recommended primitives across 7 categories, prioritized by implementation order.
Priority Legend
Critical
High
Medium
Low
Core Interaction
Fundamental communication primitives
TextMessageCriticalBasic text display with optional formattingThinkingIndicatorCriticalShow agent is processingConfirmCriticalYes/no decision pointChoiceCriticalSelect from multiple optionsProgressHighMulti-step operation statusAbortHighCancel ongoing operationInput & Forms
Data collection primitives
TextInputCriticalSingle/multi-line text entryNumberInputHighNumeric input with constraintsDatePickerMediumDate/time selectionFileUploadMediumFile attachmentToggleHighBoolean switchSliderMediumRange selectionSelectHighDropdown selectionMultiSelectMediumMultiple option selectionDisplay
Data presentation primitives
DataTableHighTabular data displayListCriticalOrdered/unordered itemsCardHighGrouped content blockCodeBlockHighSyntax-highlighted codeImageDisplayMediumImage with metadataChartLowData visualizationMarkdownHighRich text contentContext
Information and reference primitives
ContextCardHighRelevant context displayCitationMediumSource referenceReferenceMediumLink to related contentTooltipLowHover informationExpandableMediumCollapsible detailsStatus
State indication primitives
LoadingStateCriticalOperation in progressErrorDisplayCriticalError with recovery optionsSuccessIndicatorHighCompleted successfullyWarningBannerHighCaution noticeEmptyStateMediumNo content placeholderFeedback
Notification primitives
ToastHighTransient notificationAlertHighImportant noticeBadgeLowStatus indicatorCounterLowNumeric indicatorTimestampMediumTime displayLayout
Structural primitives
ContainerHighGrouping wrapperTabsMediumTabbed contentAccordionMediumCollapsible sectionsStepperMediumMulti-step flow