@actioneer/ads 0.5.9 → 0.7.0

package/llms.txt

@@ -18,9 +18,15 @@
 Reference semantic roles, never raw color/dimension literals (ads-lint rejects literals). Each role produces `bg-/text-/border-<role>` utilities:
 - `background`
 - `foreground`
-- `primary` — Text hierarchy — three accessible levels (all ≥ AA on --background)
-- `secondary` — Text hierarchy — three accessible levels (all ≥ AA on --background)
-- `tertiary` — Text hierarchy — three accessible levels (all ≥ AA on --background)
+- `on-white-primary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-white-secondary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-white-tertiary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-warm-grey-primary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-warm-grey-secondary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-warm-grey-tertiary` — Contextual text hierarchies — three accessible levels per surface.
+- `primary` — Context-free compatibility aliases remain conservative.
+- `secondary` — Context-free compatibility aliases remain conservative.
+- `tertiary` — Context-free compatibility aliases remain conservative.
 - `surface`
 - `surface-foreground`
 - `elevated`
@@ -28,18 +34,27 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - `muted-foreground`
 - `card`
 - `card-foreground`
+- `specimen-stroke`
+- `action-primary` — Primary CTA role — restrained Studio green, used sparingly.
+- `action-primary-foreground` — Primary CTA role — restrained Studio green, used sparingly.
+- `action-primary-hover` — Primary CTA role — restrained Studio green, used sparingly.
+- `action-primary-text` — Primary CTA role — restrained Studio green, used sparingly.
+- `action-primary-soft` — Primary CTA role — restrained Studio green, used sparingly.
+- `field-focus` — Primary CTA role — restrained Studio green, used sparingly.
 - `brand` — Compatibility action role — neutral ink, never a colored primary hue.
 - `brand-foreground` — Compatibility action role — neutral ink, never a colored primary hue.
 - `brand-hover` — Compatibility action role — neutral ink, never a colored primary hue.
 - `brand-text` — Compatibility action role — neutral ink, never a colored primary hue.
-- `fill` — Quiet fill — secondary buttons, avatars, chips
-- `fill-foreground` — Quiet fill — secondary buttons, avatars, chips
-- `table-shell` — Quiet fill — secondary buttons, avatars, chips
+- `fill` — Quiet fill — avatars, chips, and disabled controls
+- `fill-foreground` — Quiet fill — avatars, chips, and disabled controls
+- `table-shell` — Quiet fill — avatars, chips, and disabled controls
+- `table-stroke` — Quiet fill — avatars, chips, and disabled controls
+- `table-header-foreground` — Quiet fill — avatars, chips, and disabled controls
 - `artifact-canvas`
 - `accent`
 - `accent-foreground`
-- `success` — success-700 on white = 5.48:1 (600 was 3.77:1, failed AA).
-- `success-foreground` — success-700 on white = 5.48:1 (600 was 3.77:1, failed AA).
+- `success` — Lichen success-700 clears AA on White and both success soft fills;
+- `success-foreground` — Lichen success-700 clears AA on White and both success soft fills;
 - `warning` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
 - `warning-foreground` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
 - `danger` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
@@ -52,6 +67,9 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - `border`
 - `border-strong`
 - `input`
+- `menu-stroke`
+- `toast-stroke`
+- `tree-stroke`
 - `ring`
 - `overlay`
 
@@ -61,23 +79,27 @@ The house rules for every ADS UI. `[lint]` = `@actioneer/ads-lint` auto-checks i
 
 ### 1. Prefer fills & elevation over strokes — but keep a balance (~75/25) [judgment]
 
-Delineate SURFACES (cards, panels, sidebars, page regions) with color contrast, elevation, and spacing — not borders. Aim for ~75% shadow/fill, 25% strokes: form controls and floating menus keep a subtle border so they read as interactive; surfaces do not.
+Delineate SURFACES (cards, panels, sidebars, page regions) with color contrast, elevation, and spacing — not borders. Keep no more than two persistent neutral layers in one composition: panels establish hierarchy; embedded items express state. Aim for ~75% shadow/fill, 25% strokes: form controls and floating menus keep a subtle border so they read as interactive; surfaces do not.
 
-- Do: Separate regions by fill color first: bg-background → bg-surface → bg-card/bg-elevated → bg-muted.
+- Do: Establish hierarchy with at most two persistent layers: bg-background for the screen ground and bg-card/bg-elevated for the primary surface.
+- Do: Inside a white Panel or Card, keep rows and items transparent at rest; group them with spacing or inset dividers, use bg-muted for hover/selection, and reserve bg-surface for one continuous semantic recess such as an editor or table tray.
 - Do: Use border-border for outline buttons and lightweight action rows; reserve border-input for form controls (input, select, textarea, checkbox, radio, segmented-control track) and floating menus (dropdown, popover, listboxes).
 - Do: Keep strokes on focus rings, the outline Button/Badge/Chip variants, Kbd, Divider, the Tree connector rail, and functional color swatches.
 - Don't: Add a border to a surface to separate or group it — use fill/elevation/spacing instead.
+- Don't: Alternate persistent neutral fills inside one panel (for example white Panel → grey item → white child); flatten the item or promote the recess to the container.
 - Don't: Give a filled control no stroke on the tinted canvas — it disappears; it needs a crisp edge.
 
-### 2. Elevation = actionability [judgment]
+### 2. Shadow only by request [judgment]
 
-The single shadow-elevation token is an affordance: it goes ONLY on surfaces the user can act on. Never elevate something that can't be clicked. There is no shadow scale.
+Every surface defaults to shadow-0. Use the numbered elevation ladder only when the user explicitly requests a shadow for the named surface; the legacy shadow-elevation hook remains flat.
 
-- Do: Elevate actionable surfaces: pressable/hoverable cards, primary CTAs, control thumbs (Switch, Slider, active tab segments), and interactive floating layers (Modal, Drawer, Popover, Dropdown, listboxes, Toast).
-- Do: Keep static surfaces flat: Panel, plain Card, Kbd, Navbar, headers, rails, docs boxes, Tooltip, InlineDrawer — they read by fill/color.
-- Do: Ask 'can the user click this surface?' — if no, it's flat.
-- Don't: Reintroduce a shadow scale (shadow-xs/sm/md/lg/xl) — there is one token only, shadow-elevation.
+- Do: Keep controls, cards, menus, overlays, panels, and other surfaces at shadow-0 unless the user specifically requests elevation.
+- Do: When requested, use shadow-100 for controls, shadow-200 for raised surfaces and pressable cards, shadow-300 for menus, popovers, listboxes, and toasts, and shadow-400 for dialogs and overlay drawers.
+- Do: Reserve shadow-500 and shadow-600 for rare higher stacked layers; the legacy shadow-elevation hook resolves to shadow-0.
+- Don't: Infer permission to use a shadow from actionability, floating placement, or component type.
+- Don't: Use raw shadow values or legacy shadow-sm/md/lg/xl utilities.
 - Don't: Put a shadow on a non-interactive surface for decoration.
+- Don't: Use shadow-500 or shadow-600 as a routine default.
 
 ### 3. Motion follows the interaction [lint: unbounded-transition, sluggish-easing, zero-scale-entrance, undersized-zoom-entrance, raw-spring-config]
 
@@ -134,9 +156,11 @@ A screen carries ONLY what the user needs to move forward: one title, the inputs
 
 - Do: Prefer more, smaller steps over dense ones; ask one thing at a time.
 - Do: Derive instead of asking whenever possible (a name from a work email, the company from its domain).
+- Do: Prefer clear text-only buttons; add an icon only when it communicates essential meaning the label cannot carry alone, or for a compact conventional icon-only control.
 - Do: Render multi-step flows full-screen — a single content container that holds the inputs and its own Back/Continue is fine.
 - Don't: Add section eyebrows above a title that already names the screen, or helper text that restates the obvious / duplicates a disabled button's meaning.
 - Don't: Add any header description unless the user explicitly requested supporting copy for that page, section, panel, modal, dialog, drawer, or popover.
+- Don't: Decorate a labeled button with a redundant leading or trailing icon.
 - Don't: Nest panel/step-rail chrome inside a multi-step flow.
 
 ### 9. Responsive = container-fluid components, shells own the width [judgment]
@@ -144,7 +168,7 @@ A screen carries ONLY what the user needs to move forward: one title, the inputs
 ADS targets landscape tablet (1024) → laptop (1440) → wide display (1920+); phone/portrait is out of scope. Components adapt to their CONTAINER via container queries; shells and pages decide pane widths through width tokens. Design against under-utilization, not cramping.
 
 - Do: Use @container on the pane and @lg:/@xl: variants on children inside components.
-- Do: Set pane widths in shells/pages through width tokens (--thread-max-width, --sidebar-width, --aside-width, --connector-card-min/-max).
+- Do: Set pane widths in shells/pages through width tokens (thread-max-width, sidebar-width, aside-width, connector-card-min/-max).
 - Do: Cap prose at its measure; let tables/charts/tool cards break out wider. Use auto-fill + minmax(min, 1fr) for grids.
 - Don't: Use sm:/md: viewport variants inside src/components, or hardcode a pane width there.
 - Don't: Cap a grid at a hard column count so it stops growing on wide displays.
@@ -168,6 +192,20 @@ When tabs and a search field control the same content, they share one responsive
 - Don't: Put a scoped search field on a separate row above its tabs when both controls fit side by side.
 - Don't: Place search before tabs in the reading or keyboard order.
 
+## UI grammar
+
+Before composing a screen, match its intent to one production below, preserve the named JSX tree, then query the design graph for required component states. State axes are independent; render only the representative combinations named by the graph instead of a Cartesian product.
+
+- `standard-screen` — Standard screen: One shell-owned screen frame containing a single primary Panel. (intents: screen, page, workspace, editor, detail page; Storybook: ADS/Components/Layout/Panel)
+- `browse-with-detail` — Browse with selection-driven detail: A primary browse Panel and an inline Drawer mounted as shell-level siblings. (intents: browse, records, list detail, inspector, audit log; Storybook: ADS/Components/Navigation/Sidebar)
+- `data-table` — Structured data table: Semantic table anatomy with matching header and body rows. (intents: table, records, comparison, sorting, selection; Storybook: ADS/Components/Data display/Table)
+- `tabbed-results` — Tabbed results with scoped search: Tabs lead and a scoped search trails in one responsive control row. (intents: tabs, filter, search, results, segmented views; Storybook: ADS/Components/Data display/Tabs)
+- `modal-task` — Blocking modal task: A focused interruption with one title, body, and decisive footer. (intents: modal, confirmation, short form, blocking task, destructive action; Storybook: ADS/Components/Overlays/Modal)
+- `settings-card` — Settings card: A compact settings surface with grouped SettingRows and one save action. (intents: settings, preferences, configuration, toggles; Storybook: ADS/Recipes/Settings panel)
+- `research-trace` — Inspectable research trace: ResearchActivity owns the run summary and contains the canonical ChainOfThought tree. (intents: agent trace, research, tool activity, sources, long-running task; Storybook: ADS/Components/AI Elements/Research Activity)
+- `typed-answer` — Typed research answer: A request/answer turn where structured output flows through AnswerRenderer. (intents: answer, research result, citations, follow-up, assistant response; Storybook: ADS/Components/AI Elements/Message)
+- `workflow-canvas` — Workflow canvas: InfiniteCanvas owns pan, zoom, grid, edges, controls, and responsive canvas chrome. (intents: workflow, node graph, canvas, diagram, flow builder; Storybook: ADS/Components/Data display/InfiniteCanvas)
+
 ## Components
 
 Before using any component below, preserve its built-in motion and apply the motion contract in Setup step 5.
@@ -205,7 +243,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 ### Foundations
 
 - [AudioWaveform] — component [docs](https://ads.actioneer.dev/#/audio-waveform)
-- [Button] — Use Button for any pressable action — a primary CTA, secondary action, or icon-only control — choosing variant by emphasis and size by context. (variants: variant: solid|secondary|outline|ghost|soft|link|danger; size: xs|sm|md|lg|icon|icon-sm|icon-xs) [docs](https://ads.actioneer.dev/#/button)
+- [Button] — Use Button for any pressable action and prefer a clear text-only label. Add an icon only when it communicates essential meaning the label cannot carry alone; reserve icon-only buttons for compact, repeated controls with universally understood symbols and an accessible label. (variants: variant: solid|secondary|outline|ghost|link|danger; size: xs|sm|md|lg|icon|icon-sm|icon-xs) [docs](https://ads.actioneer.dev/#/button)
 - [Code] — Use inline within a Text/paragraph to mark a literal token — a command, filename, variable, or short snippet — never as a block-level code display. [docs](https://ads.actioneer.dev/#/typography)
 - [CodeBlock] — Show multi-line source — a query, config, or tool payload — by passing it as a string child. The default treatment is an unfilled outlined filename toolbar above a white outlined source surface, separated by the toolbar's bottom stroke. Line numbers are on by default; add language for syntax highlighting and dedicated props for highlighted, added, or removed lines. Use inline Code for a token inside a sentence. (variants: variant: soft|plain) [docs](https://ads.actioneer.dev/#/code-block)
 - [Divider] — Separate grouped content or inline clusters with a thin rule instead of adding a border to the container. [docs](https://ads.actioneer.dev/#/divider)
@@ -216,7 +254,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Heading] — Use Heading for semantic h1–h4 titles above a page, section, or card, sized by document level via `level` (never a `size` prop). [docs](https://ads.actioneer.dev/#/typography)
 - [Kbd] — Use to display a keyboard shortcut or key name, inline in text or trailing a label in a shortcut list. [docs](https://ads.actioneer.dev/#/kbd)
 - [Label] — component [docs](https://ads.actioneer.dev/#/field)
-- [Link] — Use Link for inline or standalone anchor navigation; add isExternal for links that leave the app. [docs](https://ads.actioneer.dev/#/link)
 - [ResizablePanel] — component [docs](https://ads.actioneer.dev/#/review/resizable-panel)
 - [Reveal] — Choreograph a data surface's entrance instead of a skeleton swap: wrap the shell, labels, values, and charts in ordered Reveals so the layout lands instantly and the content draws itself in. [docs](https://ads.actioneer.dev/#/reveal)
 - [RevealGroup] — component [docs](https://ads.actioneer.dev/#/reveal)
@@ -236,7 +273,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [FileDropzoneProps] — TypeScript type
 - [HeadingProps] — TypeScript type
 - [KbdProps] — TypeScript type
-- [LinkProps] — TypeScript type
 - [ResizablePanelProps] — TypeScript type
 - [RevealGroupProps] — TypeScript type
 - [RevealProps] — TypeScript type
@@ -265,12 +301,13 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Autocomplete] — Use for a single-select text field that filters a known list of options as the user types, with keyboard navigation and a selected-match checkmark. [docs](https://ads.actioneer.dev/#/autocomplete)
 - [Checkbox] — Use for a standalone boolean toggle or a multi-select list item — including a tri-state "select all" via `indeterminate`. [docs](https://ads.actioneer.dev/#/checkbox)
 - [CheckboxGroup] — component [docs](https://ads.actioneer.dev/#/checkbox)
+- [DateRangePicker] — component [docs](https://ads.actioneer.dev/#/date-range-picker)
 - [Input] — Use for any single-line text value, wrapped in `Field` for label/description/error and `startContent`/`endContent` for icons or inline actions. [docs](https://ads.actioneer.dev/#/input)
 - [InputField] — component [docs](https://ads.actioneer.dev/#/input-field)
 - [NumberField] — Use for a bounded numeric quantity (e.g. seats, width, count) that benefits from stepper buttons and min/max clamping, not free-form numeric text entry. [docs](https://ads.actioneer.dev/#/number-field)
 - [Radio] — Use for choosing exactly one option from a small, fully visible set — wrap Radio options in a RadioGroup that owns the shared name and controlled value. [docs](https://ads.actioneer.dev/#/radio)
 - [RadioGroup] — component [docs](https://ads.actioneer.dev/#/radio)
-- [SegmentedControl] — Use for a small set (2-4) of mutually exclusive, always-visible options — like a range or view-mode switcher — not for navigation or long lists. Radius follows control size: 4px at sm and 8px at md/lg; tracks and options are never fully rounded. (variants: size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/segmented)
+- [SegmentedControl] — Use for a small set (2-4) of mutually exclusive, always-visible options — like a range or view-mode switcher — not for navigation or long lists. Radius follows control size: 4px at sm and 6px at md/lg; tracks and options are never fully rounded. (variants: size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/segmented)
 - [Select] — Use for a single choice from a closed list of options in a form, especially when pairing with Field for a labeled control. (variants: size: sm|md|lg) [docs](https://ads.actioneer.dev/#/select)
 - [Slider] — Use for a single controlled numeric value picked from a bounded range (volume, brightness, threshold) — pair with Field or Label/Text for an accessible, labeled control. [docs](https://ads.actioneer.dev/#/slider)
 - [Switch] — Use for a single binary on/off preference that applies immediately, not as part of a form submitted later. [docs](https://ads.actioneer.dev/#/switch)
@@ -279,6 +316,9 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [AutocompleteProps] — TypeScript type
 - [CheckboxGroupProps] — TypeScript type
 - [CheckboxProps] — TypeScript type
+- [DateRangePickerProps] — TypeScript type
+- [DateRangeValue] — TypeScript type
+- [DropdownOptionsProps] — TypeScript type
 - [InputFieldProps] — TypeScript type
 - [InputProps] — TypeScript type
 - [NumberFieldProps] — TypeScript type
@@ -291,6 +331,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [SliderProps] — TypeScript type
 - [SwitchProps] — TypeScript type
 - [TextareaProps] — TypeScript type
+- [DropdownOptions] — utility
 
 ### Overlays
 
@@ -306,26 +347,32 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [DropdownLabel] — component [docs](https://ads.actioneer.dev/#/dropdown)
 - [DropdownSeparator] — component [docs](https://ads.actioneer.dev/#/dropdown)
 - [DropdownTrigger] — component [docs](https://ads.actioneer.dev/#/dropdown)
+- [FloatingDrawer] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
 - [InlineDrawer] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
-- [Modal] — Use for a blocking, focused task or confirmation that must interrupt the page until resolved (portaled, focus-trapped, Escape/backdrop dismissible). (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalBody] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalDescription] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
+- [Modal] — Use for a blocking, focused task or confirmation that must interrupt the page until resolved (portaled, focus-trapped, Escape/backdrop dismissible). (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalBody] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalClose] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalDescription] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
 - [ModalDrawer] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
-- [ModalFooter] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalHeader] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalTitle] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalFooter] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalHeader] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalSection] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalTitle] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
 - [Popover] — Use Popover for a portaled, dismissible panel anchored to a trigger — quick settings, a profile card, or a short inline form — that closes on outside click or Escape. [docs](https://ads.actioneer.dev/#/popover)
 - [PopoverContent] — component [docs](https://ads.actioneer.dev/#/popover)
 - [PopoverTrigger] — component [docs](https://ads.actioneer.dev/#/popover)
 - [ToastProvider] — component [docs](https://ads.actioneer.dev/#/toast)
 - [CommandPaletteItem] — TypeScript type
 - [CommandPaletteProps] — TypeScript type
+- [DrawerAppearance] — TypeScript type
 - [DrawerProps] — TypeScript type
 - [DropdownContentProps] — TypeScript type
 - [DropdownItemProps] — TypeScript type
 - [DropdownProps] — TypeScript type
 - [DropdownTriggerProps] — TypeScript type
+- [FloatingDrawerProps] — TypeScript type
 - [InlineDrawerProps] — TypeScript type
+- [ModalBodyProps] — TypeScript type
 - [ModalDrawerProps] — TypeScript type
 - [ModalProps] — TypeScript type
 - [PopoverContentProps] — TypeScript type
@@ -345,14 +392,14 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [AccordionItem] — component [docs](https://ads.actioneer.dev/#/accordion)
 - [AnswerRenderer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [AnswerSkeleton] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
-- [AnswerSourceChip] — Use the blue connector/source chip inside AnswerSources to open only the referenced nodes represented by that chip in the shell's inspector. [docs](https://ads.actioneer.dev/#/ai/sources)
-- [AnswerSourceInspector] — Render as a separate white shell-level panel beside the answer when a source chip is selected; close and unmount it when the selection clears. [docs](https://ads.actioneer.dev/#/ai/sources)
-- [AnswerSourceItem] — Use as an outlined clickable row inside AnswerSourceInspector for one referenced table or node, including its parent source, read state, and optional status. [docs](https://ads.actioneer.dev/#/ai/sources)
-- [AnswerSources] — Place immediately above an answer's follow-up questions to summarize the referenced nodes and group them into clickable AnswerSourceChips. [docs](https://ads.actioneer.dev/#/ai/sources)
+- [AnswerSourceChip] — Use the blue connector/source chip inside AnswerSources to open only the referenced nodes represented by that chip in the shell's inspector. [docs](https://ads.actioneer.dev/#/ai/answer)
+- [AnswerSourceInspector] — Render as a persistent right-side sibling when a source or node is selected, then unmount it when that context clears. Execution contract: use a transparent split wrapper with an 8px gap; keep the inspector fixed at 320px and shrink-0 while the primary panel stays min-w-0; use a bg-background canvas, bg-card panels, bg-surface detail rows, independent border-border strokes, text-primary/text-secondary/text-tertiary text, and bg-action-primary CTAs (bg-action-primary-hover on hover); apply the 2/4/6/8px radius scale with 8px on panels and rows, 24px panel padding, and no panel shadow; keep the split workspace wrapper transparent, borderless, shadowless, and square; never fill the gutter or draw one shared border around both panels. [docs](https://ads.actioneer.dev/#/ai/answer)
+- [AnswerSourceItem] — Use as an outlined clickable row inside AnswerSourceInspector for one referenced table or node, including its parent source, read state, and optional status. [docs](https://ads.actioneer.dev/#/ai/answer)
+- [AnswerSources] — Place immediately above an answer's follow-up questions to summarize the referenced nodes and group them into clickable AnswerSourceChips. [docs](https://ads.actioneer.dev/#/ai/answer)
 - [AreaChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [Avatar] — Use to represent a person or entity as a compact photo-or-initials glyph, standalone or stacked in an AvatarGroup. [docs](https://ads.actioneer.dev/#/avatar)
 - [AvatarGroup] — component [docs](https://ads.actioneer.dev/#/avatar)
-- [Badge] — Use Badge for a small inline label — status, counts, or tags — attached to text or a row. (variants: variant: solid|soft|outline|dot; color: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/badge)
+- [Badge] — Use Badge for a small inline label — status, counts, or tags — attached to text or a row. [docs](https://ads.actioneer.dev/#/badge)
 - [BarChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [BaseEdge] — component [docs](https://ads.actioneer.dev/#/infinite-canvas)
 - [BreakdownAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
@@ -368,7 +415,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [CarouselItem] — component [docs](https://ads.actioneer.dev/#/carousel)
 - [CarouselNext] — component [docs](https://ads.actioneer.dev/#/carousel)
 - [CarouselPrevious] — component [docs](https://ads.actioneer.dev/#/carousel)
-- [Chip] — A compact pill for statuses, tags, or metadata, with an optional leading icon/avatar or a dismiss control. (variants: variant: solid|soft|outline|dot; color: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/chip)
+- [Chip] — A compact pill for statuses, tags, or metadata, with an optional leading icon/avatar or a dismiss control. (variants: variant: solid|outline; color: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/chip)
 - [ClarificationAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [ComboChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [ComparisonAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
@@ -382,6 +429,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ErrorAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [ExplanationAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [FactAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
+- [FollowUpQuestion] — Use for the two or three full-width next-question rows that close a structured answer, immediately after its source strip; show the exact prompt that clicking will send. (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [FunnelBarsHorizontal] — component [docs](https://ads.actioneer.dev/#/viz-charts)
 - [FunnelChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [FunnelViz] — component [docs](https://ads.actioneer.dev/#/viz-charts)
@@ -404,7 +452,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ScatterChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [SeriesChart] — component [docs](https://ads.actioneer.dev/#/viz-charts)
 - [StatusAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
-- [Tab] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [Tab] — component (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
 - [Table] — Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. Primary record links stay text-only in every state: never reveal an arrow, chevron, or other directional icon only on hover. Persistent row actions use a final sticky-right column plus elevatedActionColumn so one body-column shadow lifts the action surface instead of repeating on individual cells. The empty matching header cell remains transparent and non-sticky. [docs](https://ads.actioneer.dev/#/table)
 - [TableAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [TableBody] — component [docs](https://ads.actioneer.dev/#/table)
@@ -412,10 +460,10 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [TableColumn] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableHeader] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableRow] — component [docs](https://ads.actioneer.dev/#/table)
-- [TabList] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg) [docs](https://ads.actioneer.dev/#/tabs)
-- [TabPanel] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
-- [Tabs] — Use Tabs to switch between mutually exclusive views/sections that share the same page context, not for page-level navigation. Always reach for the primary recessed-track variant — it is the default; use secondary only when explicitly asked for it. Tab radius follows control size (4px sm, 8px md/lg), never rounded-full. When Tabs and a scoped search field coexist, compose one responsive control row with tabs leading and search trailing; do not stack search above tabs at widths where both fit. (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
-- [TabSeparator] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [TabList] — component (variants: orientation: horizontal|vertical) [docs](https://ads.actioneer.dev/#/tabs)
+- [TabPanel] — component (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [Tabs] — Use Tabs to switch between mutually exclusive views/sections that share the same page context, not for page-level navigation. Always reach for the primary recessed-track variant — it is the default; use secondary only when explicitly asked for it. Tab radius follows control size: 4px at sm and 8px at md/lg, never rounded-full. When Tabs and a scoped search field coexist, compose one responsive control row with tabs leading and search trailing; do not stack search above tabs at widths where both fit. (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [TabSeparator] — component (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
 - [Timeline] — Use for a vertical rail of dated events — version history, audit trails, activity/status feeds. [docs](https://ads.actioneer.dev/#/timeline)
 - [TimelineItem] — component [docs](https://ads.actioneer.dev/#/timeline)
 - [Tree] — component [docs](https://ads.actioneer.dev/#/tree)
@@ -464,6 +512,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ChartTooltipItem] — TypeScript type
 - [ChartTooltipRenderer] — TypeScript type
 - [ChartXScale] — TypeScript type
+- [ChipInteraction] — TypeScript type
 - [ChipProps] — TypeScript type
 - [ClarificationAnswerProps] — TypeScript type
 - [ClarificationAnswerSpec] — TypeScript type
@@ -494,6 +543,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ExplanationAnswerSpec] — TypeScript type
 - [FactAnswerProps] — TypeScript type
 - [FactAnswerSpec] — TypeScript type
+- [FollowUpQuestionProps] — TypeScript type
 - [FunnelBarsHorizontalProps] — TypeScript type
 - [FunnelChartProps] — TypeScript type
 - [FunnelLabelContext] — TypeScript type
@@ -548,6 +598,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [TreeItemProps] — TypeScript type
 - [TreemapChartProps] — TypeScript type
 - [TreemapDatum] — TypeScript type
+- [TreeProps] — TypeScript type
 - [TrendAnswerProps] — TypeScript type
 - [TrendAnswerSpec] — TypeScript type
 - [Viewport] — TypeScript type
@@ -596,11 +647,9 @@ Before using any component below, preserve its built-in motion and apply the mot
 
 ### Feedback
 
-- [AgentIcon] — component [docs](https://ads.actioneer.dev/#/agent-icon)
-- [Alert] — Use for persistent inline status messaging on a page (not toasts) — a neutral surface where only the icon and title carry variant color. (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
+- [Alert] — Use for inline status messaging on a raised white surface. Add duration for a temporary announcement with a countdown bar; otherwise it remains persistent. (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
 - [AlertDescription] — component (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
 - [AlertTitle] — component (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
-- [BrandLoader] — Use for a branded loading/generating indicator (inline in a text row or as a standalone full-screen moment) instead of a generic spinner. [docs](https://ads.actioneer.dev/#/brand-loader)
 - [BrandMark] — component [docs](https://ads.actioneer.dev/#/brand-loader)
 - [BrandTexture] — Place the ambient halftone wash behind a welcome or hero surface inside a relative container; set lifted when real content takes over so the field dissolves upward, and paused a beat later to stop the shader clock. [docs](https://ads.actioneer.dev/#/brand-texture)
 - [BrandTextureField] — component [docs](https://ads.actioneer.dev/#/brand-texture)
@@ -610,41 +659,31 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [EmptySearch] — component [docs](https://ads.actioneer.dev/#/empty-state)
 - [EmptyState] — Use as the centered placeholder inside a list, table, or panel that currently has nothing to show. [docs](https://ads.actioneer.dev/#/empty-state)
 - [PixelBlastSVG] — component [docs](https://ads.actioneer.dev/#/pixel-blast-svg)
-- [PixelIcon] — component [docs](https://ads.actioneer.dev/#/pixel-icon)
 - [Progress] — Use for a determinate or indeterminate bar showing task completion, driven by a value/max (default 100). [docs](https://ads.actioneer.dev/#/progress)
 - [ProgressCircle] — Use for a compact circular loading/progress indicator (determinate or indeterminate) where a linear bar doesn't fit, e.g. inline with a caption or a small avatar-sized control. [docs](https://ads.actioneer.dev/#/progress-circle)
 - [Ripple] — component [docs](https://ads.actioneer.dev/#/ripple)
 - [Skeleton] — Placeholder the shape of content that's still loading — size it via className and pair with circle for avatars. [docs](https://ads.actioneer.dev/#/skeleton)
-- [AgentIconColorPreset] — TypeScript type
-- [AgentIconName] — TypeScript type
-- [AgentIconProps] — TypeScript type
-- [AgentIconState] — TypeScript type
+- [SurfaceLoader] — Use for any whole panel, modal, or page that is temporarily blocked; it owns the ADS surface spinner, visible status, spacing, and busy semantics. [docs](https://ads.actioneer.dev/#/surface-loader)
 - [AlertProps] — TypeScript type
-- [BrandLoaderProps] — TypeScript type
 - [BrandMarkProps] — TypeScript type
 - [BrandTextureProps] — TypeScript type
 - [EmptyStateProps] — TypeScript type
 - [PixelBlastSVGProps] — TypeScript type
-- [PixelIconMask] — TypeScript type
-- [PixelIconProps] — TypeScript type
 - [ProgressCircleProps] — TypeScript type
 - [ProgressProps] — TypeScript type
 - [RippleProps] — TypeScript type
 - [SkeletonProps] — TypeScript type
-- [AGENT_ICON_NAMES] — utility
-- [AGENT_ICONS] — utility
+- [SurfaceLoaderProps] — TypeScript type
 
 ### Navigation
 
+- [BodyPageHeader] — component [docs](https://ads.actioneer.dev/#/body-page-header)
 - [BreadcrumbItem] — component [docs](https://ads.actioneer.dev/#/breadcrumbs)
 - [Breadcrumbs] — Use to show a page's location in a hierarchy as a trail of parent links ending in the current page. Keep item labels text-only; the component supplies right-chevron separators. Each drill-down level gets a full-width 48px bar with a subtle bottom stroke. [docs](https://ads.actioneer.dev/#/breadcrumbs)
-- [Navbar] — Use for a sticky top-of-page nav shell with a brand slot, justified link/action groups, and active-state item links. (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [NavbarBrand] — component (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [NavbarContent] — component (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [NavbarItem] — component (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [PageHeader] — Use for every page title row; supply onBack to anchor an icon-only back arrow immediately before the title, never in the trailing actions area. [docs](https://ads.actioneer.dev/#/page-header)
+- [CollectionHeader] — Use for a top-level sidebar destination or collection. Supply the destination icon, keep search and secondary controls before one compact primary action, and place collection content below its built-in separator. [docs](https://ads.actioneer.dev/#/collection-header)
+- [PageHeader] — Use for detail, create, and edit page title rows; supply onBack to anchor an icon-only back arrow immediately before the title. Use CollectionHeader for top-level sidebar destinations and collections. [docs](https://ads.actioneer.dev/#/page-header)
 - [Pagination] — Use for navigating multi-page numbered content — table footers, search results, or any list too long for one screen. [docs](https://ads.actioneer.dev/#/pagination)
-- [Sidebar] — Use as an app's vertical navigation rail. The canonical Actioneer shell pairs one collapsible global product rail with one fixed contextual Sidebar inside the shared workspace Panel; only the global rail owns a collapse control. Compose SidebarBrand, grouped SidebarItems, optional SidebarHistory, and SidebarAccount as the area requires. [docs](https://ads.actioneer.dev/#/sidebar)
+- [Sidebar] — Use as an app's vertical navigation rail. The canonical Actioneer shell uses one collapsible Sidebar for product areas and the active area's grouped internal options. Compose SidebarBrand, grouped SidebarItems, optional SidebarHistory, and SidebarAccount as the area requires. [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarAccount] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarAction] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarBrand] — component [docs](https://ads.actioneer.dev/#/sidebar)
@@ -656,10 +695,10 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [SidebarNav] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarSection] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarTrigger] — component [docs](https://ads.actioneer.dev/#/sidebar)
+- [BodyPageHeaderProps] — TypeScript type
 - [BreadcrumbItemProps] — TypeScript type
 - [BreadcrumbsProps] — TypeScript type
-- [NavbarContentProps] — TypeScript type
-- [NavbarItemProps] — TypeScript type
+- [CollectionHeaderProps] — TypeScript type
 - [PageHeaderProps] — TypeScript type
 - [PaginationProps] — TypeScript type
 - [SidebarAccountProps] — TypeScript type
@@ -677,6 +716,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Collapsible] — Reach for it to build a single disclosure row, detail panel, or FAQ item that expands/collapses in place — compose several instances for a list since ADS has no accordion-group wrapper. [docs](https://ads.actioneer.dev/#/collapsible)
 - [CollapsibleContent] — component [docs](https://ads.actioneer.dev/#/collapsible)
 - [CollapsibleTrigger] — component [docs](https://ads.actioneer.dev/#/collapsible)
+- [PageBody] — component [docs](https://ads.actioneer.dev/#/page-body)
 - [Panel] — Use Panel for app-frame regions (editors, previews, side columns, tool windows) that need a fixed header/footer around independently scrolling body content. [docs](https://ads.actioneer.dev/#/panel)
 - [PanelBody] — component [docs](https://ads.actioneer.dev/#/panel)
 - [PanelFooter] — component [docs](https://ads.actioneer.dev/#/panel)
@@ -685,6 +725,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [PanelToolbar] — component [docs](https://ads.actioneer.dev/#/panel)
 - [SelectionActionBar] — Render it above a selectable list or table once selectedCount is greater than zero, to summarize the selection and expose bulk actions plus a clear control. [docs](https://ads.actioneer.dev/#/selection-action-bar)
 - [SelectionActionBarAction] — component [docs](https://ads.actioneer.dev/#/selection-action-bar)
+- [PageBodyProps] — TypeScript type
 - [SelectionActionBarProps] — TypeScript type
 
 ### AI Elements
@@ -704,20 +745,20 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ChainOfThoughtSearchResults] — component [docs](https://ads.actioneer.dev/#/ai/chain-of-thought)
 - [ChainOfThoughtStep] — component [docs](https://ads.actioneer.dev/#/ai/chain-of-thought)
 - [ChainOfThoughtTrigger] — component [docs](https://ads.actioneer.dev/#/ai/chain-of-thought)
-- [InlineCitation] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCard] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCardBody] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCardTrigger] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarousel] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselContent] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselHeader] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselIndex] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselItem] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselNext] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselPrev] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationQuote] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationSource] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationText] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
+- [InlineCitation] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCard] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCardBody] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCardTrigger] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarousel] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselContent] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselHeader] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselIndex] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselItem] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselNext] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselPrev] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationQuote] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationSource] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationText] — component [docs](https://ads.actioneer.dev/#/inline-citation)
 - [Message] — component (variants: align: start|end) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageAction] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageActions] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
@@ -734,43 +775,14 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [MessageMeta] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageResponse] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageToolbar] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
-- [Queue] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItem] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemAction] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemActions] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemAttachment] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemContent] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemDescription] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemFile] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemImage] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemIndicator] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueList] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSection] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSectionContent] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSectionLabel] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSectionTrigger] — component [docs](https://ads.actioneer.dev/#/ai/queue)
 - [ResearchActivity] — Wrap a multi-step research trace that may run for minutes; pass activity so the run reads as one morphing live line with the full trace a click away, then settle into its source count, duration, and first-insight time. (variants: status: active|complete) [docs](https://ads.actioneer.dev/#/ai/research-activity)
-- [Shimmer] — component [docs](https://ads.actioneer.dev/#/ai/shimmer)
-- [SpeechInput] — component [docs](https://ads.actioneer.dev/#/ai/speech-input)
-- [Task] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskContent] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskItem] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskItemFile] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskProgress] — Keep a multi-step answer’s current task, elapsed time, completed work, and pending work visible in a collapsible dock above the chat composer. (variants: isSticky: true|false) [docs](https://ads.actioneer.dev/#/ai/task-progress)
-- [TaskProgressDock] — component (variants: isSticky: true|false) [docs](https://ads.actioneer.dev/#/ai/task-progress)
-- [TaskTrigger] — component [docs](https://ads.actioneer.dev/#/ai/task)
+- [Shimmer] — component [docs](https://ads.actioneer.dev/#/shimmer)
 - [ToolContent] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [ToolHeader] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [ToolInput] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [ToolOutput] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [TraceStateIcon] — component [docs](https://ads.actioneer.dev/#/chain-of-thought-icon)
 - [Transcript] — component [docs](https://ads.actioneer.dev/#/ai/transcript)
-- [Voice] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceConnectButton] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceControl] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceDisconnectButton] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceMuteButton] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceStatusDot] — component [docs](https://ads.actioneer.dev/#/ai/voice)
 - [ActiveChainOfThoughtState] — TypeScript type
 - [AgentTraceCall] — TypeScript type
 - [AgentTraceProps] — TypeScript type
@@ -828,36 +840,8 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [MessageResponseProps] — TypeScript type
 - [MessageRole] — TypeScript type
 - [MessageToolbarProps] — TypeScript type
-- [QueueItemActionProps] — TypeScript type
-- [QueueItemActionsProps] — TypeScript type
-- [QueueItemAttachmentProps] — TypeScript type
-- [QueueItemContentProps] — TypeScript type
-- [QueueItemDescriptionProps] — TypeScript type
-- [QueueItemFileProps] — TypeScript type
-- [QueueItemImageProps] — TypeScript type
-- [QueueItemIndicatorProps] — TypeScript type
-- [QueueItemProps] — TypeScript type
-- [QueueListProps] — TypeScript type
-- [QueueMessage] — TypeScript type
-- [QueueMessagePart] — TypeScript type
-- [QueueProps] — TypeScript type
-- [QueueSectionContentProps] — TypeScript type
-- [QueueSectionLabelProps] — TypeScript type
-- [QueueSectionProps] — TypeScript type
-- [QueueSectionTriggerProps] — TypeScript type
-- [QueueTodo] — TypeScript type
 - [ResearchActivityProps] — TypeScript type
 - [ResearchActivityStatus] — TypeScript type
-- [SpeechInputProps] — TypeScript type
-- [TaskContentProps] — TypeScript type
-- [TaskItemFileProps] — TypeScript type
-- [TaskItemProps] — TypeScript type
-- [TaskProgressDockProps] — TypeScript type
-- [TaskProgressProps] — TypeScript type
-- [TaskProgressStatus] — TypeScript type
-- [TaskProgressStep] — TypeScript type
-- [TaskProps] — TypeScript type
-- [TaskTriggerProps] — TypeScript type
 - [TextShimmerProps] — TypeScript type
 - [ToolContentProps] — TypeScript type
 - [ToolHeaderProps] — TypeScript type
@@ -869,24 +853,11 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [TranscriptProps] — TypeScript type
 - [TranscriptTone] — TypeScript type
 - [TranscriptTurn] — TypeScript type
-- [VoiceConnectButtonProps] — TypeScript type
-- [VoiceControlProps] — TypeScript type
-- [VoiceDisconnectButtonProps] — TypeScript type
-- [VoiceMuteButtonProps] — TypeScript type
-- [VoiceOrbPalette] — TypeScript type
-- [VoicePalette] — TypeScript type
-- [VoiceProps] — TypeScript type
-- [VoiceState] — TypeScript type
-- [VoiceStatusDotProps] — TypeScript type
-- [VoiceVariant] — TypeScript type
 - [aiChartVariants] — utility
 - [CHAIN_OF_THOUGHT_DESCRIPTIONS] — utility
 - [CHAIN_OF_THOUGHT_STATES] — utility
 - [resolveTraceState] — utility
 - [Tool] — utility
-- [VOICE_PALETTES] — utility
-- [VOICE_STATES] — utility
-- [VOICE_VARIANTS] — utility
 
 ### Chat
 
@@ -894,7 +865,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [AssistantMessage] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [AssistantRuntimeProvider] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [AttachmentPrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [BranchPicker] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [Composer] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ComposerAddAttachment] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ComposerAddDocument] — component [docs](https://ads.actioneer.dev/#/demo/ask)
@@ -922,8 +892,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [FileName] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [FileRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [FileSize] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [FollowUpQuestion] — Use for the two or three full-width next-question rows that close a structured answer, immediately after its source strip; show the exact prompt that clicking will send. [docs](https://ads.actioneer.dev/#/ai/follow-up-suggestions)
-- [FollowUpSuggestion] — Use only for compact runtime suggestion chips above the composer; use FollowUpQuestion for the larger answer-ending question rows. [docs](https://ads.actioneer.dev/#/ai/follow-up-suggestions)
 - [Image] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ImageActions] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ImageContentFilterError] — component [docs](https://ads.actioneer.dev/#/demo/ask)
@@ -951,11 +919,8 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Sources] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [SourceTitle] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [Thread] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [ThreadFollowupSuggestions] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ThreadMessage] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ThreadPrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [ThreadSuggestionItem] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [ThreadSuggestions] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ToolFallback] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ToolFallbackApproval] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ToolFallbackArgs] — component [docs](https://ads.actioneer.dev/#/demo/ask)
@@ -977,8 +942,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [CreateDirectiveTextOptions] — TypeScript type
 - [DeepResearchState] — TypeScript type
 - [FileRootProps] — TypeScript type
-- [FollowUpQuestionProps] — TypeScript type
-- [FollowUpSuggestionProps] — TypeScript type
 - [ImageActionsProps] — TypeScript type
 - [ImageRootProps] — TypeScript type
 - [LocalRuntimeOptions] — TypeScript type