@actioneer/ads 0.1.0 → 0.2.1

package/bin/ads-init.mjs

@@ -17,13 +17,15 @@
  *   • drop a consumer-mode `ads-lint.config.mjs`
  *     (`libraryPackage: "@actioneer/ads"`, `libraryRoot: null`)
  *
- * Per the DES-13 testing decision, the write-plan is exercised end-to-end by a
- * manual run rather than dedicated unit tests this pass.
+ * The pure write-plan (`planInit`) and the package-manager detection are covered
+ * by unit tests in ads-init.test.mjs; the applier's IO is exercised end-to-end by
+ * a manual run and the release rehearsal.
  */
 
 import fs from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
 const PKG = "@actioneer/ads";
 const STYLE_IMPORT = `@import "${PKG}/styles.css";`;
@@ -38,6 +40,7 @@ const STYLE_IMPORT = `@import "${PKG}/styles.css";`;
  * @property {string|null} layoutPath              repo-relative path to the root layout (or null)
  * @property {string|null} layoutContent
  * @property {boolean} hasAdsLintConfig
+ * @property {"npm"|"pnpm"|"yarn"|"bun"} [packageManager]  detected consumer PM (default npm)
  *
  * @typedef {Object} Edit
  * @property {"install"|"write-file"|"edit-file"|"manual"} type
@@ -49,8 +52,45 @@ const STYLE_IMPORT = `@import "${PKG}/styles.css";`;
  * @property {number} [findIndex]                  edit-file: positional replace offset (disambiguates repeated tokens)
  * @property {string} [addImport]                  edit-file: import line to prepend if absent
  * @property {string[]} [packages]                 install: package specifiers
+ * @property {"npm"|"pnpm"|"yarn"|"bun"} [manager] install: package manager to shell out to
  */
 
+/**
+ * Detect the consumer's package manager so `init` installs with THEIR tool
+ * rather than always shelling out to `npm` (which strands pnpm/yarn/bun users
+ * with a stray package-lock.json + a mixed lockfile). Precedence, most→least
+ * authoritative: the corepack `packageManager` field, the invoking PM's user
+ * agent (set when run via `pnpm dlx` / `yarn dlx` / `bunx`), then a lockfile on
+ * disk. Defaults to npm.
+ * @param {{packageManagerField?:string|null, userAgent?:string|null, lockfiles?:string[]}} [signals]
+ * @returns {"npm"|"pnpm"|"yarn"|"bun"}
+ */
+export function detectPackageManager({ packageManagerField, userAgent, lockfiles } = {}) {
+  const field = /^(pnpm|yarn|bun|npm)(@|$)/.exec(packageManagerField ?? "");
+  if (field) return field[1];
+  const ua = /^(pnpm|yarn|bun)\//.exec(userAgent ?? "");
+  if (ua) return ua[1];
+  const locks = new Set(lockfiles ?? []);
+  if (locks.has("pnpm-lock.yaml")) return "pnpm";
+  if (locks.has("yarn.lock")) return "yarn";
+  if (locks.has("bun.lockb") || locks.has("bun.lock")) return "bun";
+  return "npm";
+}
+
+/**
+ * The install invocation for a given manager: npm uses `install`, the rest use
+ * `add`.
+ * @param {"npm"|"pnpm"|"yarn"|"bun"} manager
+ * @param {string[]} packages
+ * @returns {[string, string[]]}  [command, args]
+ */
+export function installCommand(manager, packages) {
+  const verb = manager === "npm" ? "install" : "add";
+  return [manager, [verb, ...packages]];
+}
+
+const LOCKFILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lockb", "bun.lock"];
+
 /** @param {RepoState} state @returns {Edit[]} */
 export function planInit(state) {
   const edits = [];
@@ -58,7 +98,8 @@ export function planInit(state) {
   // 1. Install the package (+ motion peer for the reduced-motion provider).
   const missing = ["@actioneer/ads", "motion"].filter((p) => !state.dependencies?.[p]);
   if (missing.length) {
-    edits.push({ type: "install", title: `install ${missing.join(", ")}`, packages: missing });
+    const manager = state.packageManager ?? "npm";
+    edits.push({ type: "install", title: `install ${missing.join(", ")}`, packages: missing, manager });
   }
 
   // 2. Inject the styles.css import IMMEDIATELY AFTER `@import "tailwindcss"`.
@@ -229,6 +270,12 @@ function readRepoState(cwd) {
   const pkg = pkgRaw ? JSON.parse(pkgRaw) : {};
   const dependencies = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
 
+  const packageManager = detectPackageManager({
+    packageManagerField: pkg.packageManager ?? null,
+    userAgent: process.env.npm_config_user_agent ?? null,
+    lockfiles: LOCKFILES.filter((f) => fs.existsSync(path.join(cwd, f))),
+  });
+
   const globalCssPath = CANDIDATE_CSS.find((p) => fs.existsSync(path.join(cwd, p))) ?? null;
   const layoutPath = CANDIDATE_LAYOUT.find((p) => fs.existsSync(path.join(cwd, p))) ?? null;
 
@@ -245,6 +292,7 @@ function readRepoState(cwd) {
     layoutContent: layoutPath ? read(layoutPath) : null,
     hasAdsLintConfig:
       fs.existsSync(path.join(cwd, "ads-lint.config.mjs")) || fs.existsSync(path.join(cwd, "ads-lint.config.js")),
+    packageManager,
     _existing,
   };
 }
@@ -253,8 +301,9 @@ function applyEdit(cwd, edit) {
   const abs = edit.path ? path.join(cwd, edit.path) : null;
   switch (edit.type) {
     case "install": {
-      console.log(`  → npm install ${edit.packages.join(" ")}`);
-      execFileSync("npm", ["install", ...edit.packages], { cwd, stdio: "inherit" });
+      const [cmd, args] = installCommand(edit.manager ?? "npm", edit.packages);
+      console.log(`  → ${cmd} ${args.join(" ")}`);
+      execFileSync(cmd, args, { cwd, stdio: "inherit" });
       return;
     }
     case "write-file": {
@@ -308,7 +357,25 @@ function main() {
   console.log(`\n${PKG} init: done. Import components with \`import { Button } from "${PKG}";\``);
 }
 
-// Only run the applier when invoked as a CLI (keeps planInit importable/pure).
-if (import.meta.url === `file://${process.argv[1]}`) {
+/**
+ * True when this file is the process entry point (keeps planInit importable
+ * without triggering the applier). Compares REAL filesystem paths on both sides:
+ * npm installs the bin as a symlink (node_modules/.bin/ads -> …/ads-init.mjs),
+ * so process.argv[1] is the symlink while import.meta.url is realpath-resolved —
+ * a raw URL/string compare mismatches and `npx @actioneer/ads init` silently
+ * no-ops for every consumer. realpath'ing both sides also makes install paths
+ * with spaces or non-ASCII compare correctly.
+ */
+function invokedAsCli() {
+  const entry = process.argv[1];
+  if (!entry) return false;
+  try {
+    return fs.realpathSync(entry) === fs.realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+
+if (invokedAsCli()) {
   main();
 }

package/llms.txt

@@ -48,6 +48,95 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - `ring`
 - `overlay`
 
+## Design principles
+
+The house rules for every ADS UI. `[lint]` = `@actioneer/ads-lint` auto-checks it (pair with `lint_snippet`); `[judgment]` = you must self-apply it — the linter can't.
+
+### 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.
+
+- Do: Separate regions by fill color first: bg-background → bg-surface → bg-card/bg-elevated → bg-muted.
+- Do: Keep a subtle border-input/border-border on 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: Give a filled control no stroke on the tinted canvas — it disappears; it needs a crisp edge.
+
+### 2. Elevation = actionability [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.
+
+- Do: Elevate actionable surfaces: pressable/hoverable cards, primary CTAs, control thumbs (Switch, Slider, active pills), 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.
+- Don't: Put a shadow on a non-interactive surface for decoration.
+
+### 3. Motion follows the design-engineering guide [lint: unbounded-transition, sluggish-easing, zero-scale-entrance, undersized-zoom-entrance]
+
+Every easing/duration/scale flows from a token (--ease-*, --duration-*, --scale-press), mirrored for Motion in src/lib/motion.ts. UI animations stay under 300ms, exits run faster than enters, and reduced motion is respected everywhere.
+
+- Do: Use strong curves only — the ease-out utility is the right default; overlays scale in origin-aware from their trigger.
+- Do: Give pressable elements a --scale-press on :active (text/link exempt); start entrances ≥ scale 0.95 with opacity.
+- Do: Respect reduced motion: keep opacity/color fades, drop movement.
+- Don't: Use a slow-starting (accelerating) easing on UI, an unbounded all-property transition, a scale-from-zero entrance, or a UI duration at or over 300ms.
+- Don't: Animate keyboard-initiated or 100×/day actions (e.g. a command-palette toggle).
+
+### 4. Icons: Hugeicons, stroke only [lint: icon-package-import]
+
+All icons come from Hugeicons in the Stroke Rounded style only. Components import named icons from the @/lib/icons registry — never from an icon package directly — so a free→Pro swap or a restyle touches one file.
+
+- Do: Import icons from the @/lib/icons registry; add a new one there (stroke variant) before using it.
+- Do: Let icons default to size='1em' so they scale with text; size with a size prop or size-* class.
+- Do: Keep stroke weight at the drawn 1.5; strokeWidth={2} is the one sanctioned emphasis step.
+- Don't: Import from an icon package directly, or use solid/duotone/twotone/fill variants.
+- Don't: Use a stroke weight thinner than 1.5.
+
+### 5. Demo screens: the shell owns the frame [judgment]
+
+The demo shell applies the screen frame (inset on top/right/bottom, flush-left against the sidebar). Screens never add their own outer padding — a screen's root is flex h-full flex-col and fills the frame with Panel(s).
+
+- Do: Make a screen root flex h-full flex-col and fill the frame with Panel(s).
+- Do: Let one place (the shell) own the inset so every screen aligns to the rail.
+- Don't: Add outer padding on a screen, leaving a tinted-canvas gap on the left.
+
+### 6. Status dots are square [judgment]
+
+Indicator/status dots (Badge & Chip dot variants, ConnectionStatus, chart legend swatches, presence/pulse dots) are square — rounded-dot (2px), echoing the growth-mark's square cells — never round.
+
+- Do: Use rounded-dot for every indicator/status dot.
+- Don't: Use rounded-full on an indicator dot (the one exception is a Radio control's inner dot).
+
+### 7. ADS-first UI: use the library; extend only when asked [lint: deep-import, barrel-aliased-import, barrel-default-import, barrel-namespace-import, external-ui-import]
+
+Every UI decision stays synchronized with ADS. Before making a new screen/control/pattern, check the ADS component suite first and use the exact exported name from the public barrel. Do not hand-roll, alias, deep-import, or import external UI libraries.
+
+- Do: Use an existing ADS component by its exact exported name from the package barrel; compose existing components for layout-only patterns.
+- Do: Ask the user before extending ADS; only an explicit request authorizes new library work.
+- Do: When authorized, add the component to the right family, export its exact name through the barrel, and document it.
+- Don't: Deep-import, alias, default/namespace-import, or hand-roll a local copy of a component.
+- Don't: Import a visual component directly from the web or an npm UI library.
+
+### 8. Minimal information per screen [judgment]
+
+A screen carries ONLY what the user needs to move forward: one title, at most one short supporting line, the inputs, one primary action. Never maximalist. Promote the one message that matters typographically instead of appending muted fine print.
+
+- 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: 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: Nest panel/step-rail chrome inside a multi-step flow.
+
+### 9. Responsive = container-fluid components, shells own the width [judgment]
+
+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: 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.
+
 ## Components
 
 ### Primitives / utilities
@@ -300,6 +389,7 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - [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)
 - [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)
 - [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)
@@ -307,6 +397,7 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - [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)
 - [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)
 - [AlertProps] — TypeScript type
+- [BrandLoaderProps] — TypeScript type
 - [BrandMarkProps] — TypeScript type
 - [EmptyStateProps] — TypeScript type
 - [PixelBlastSVGProps] — TypeScript type
@@ -349,7 +440,6 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - [SidebarProps] — TypeScript type
 - [SidebarSectionProps] — TypeScript type
 - [useSidebar] — React hook
-- [href] — utility
 
 ### Layout
 
@@ -531,7 +621,133 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - [VoiceStatusDotProps] — TypeScript type
 - [VoiceVariant] — TypeScript type
 - [useReasoning] — React hook
-- [className] — utility
-- [defaultOpen] — utility
-- [safeVariant] — utility
 - [Tool] — utility
+
+### Chat
+
+- [ACTIONEER_FILE_ACCEPT] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [AssistantActionBar] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [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)
+- [ComposerAddImage] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerAttachments] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerContextProvider] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerDeepResearch] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerHarness] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerPlaceholdersProvider] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerPrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerQuotePreview] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerQuotePreviewDismiss] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerQuotePreviewIcon] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerQuotePreviewRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerQuotePreviewText] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ComposerTriggerPopover] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [CONTEXT_MIME] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [DeepResearchProvider] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [DirectiveText] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [EditComposer] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [EMPTY_COMPONENTS] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ErrorRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ErrorText] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [File] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [FileDownload] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [FileIconDisplay] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [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)
+- [FollowUpSuggestion] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [HARNESS_MIME] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [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)
+- [ImageFilename] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ImageGenerating] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ImagePreview] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ImageRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ImageZoom] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [MarkdownText] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [MessageError] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [MessagePrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [MessageTiming] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [OpenUiLibraryProvider] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [QuoteBlock] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [QuoteBlockIcon] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [QuoteBlockRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [QuoteBlockText] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [RenderAnswerToolUI] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SelectionToolbar] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SelectionToolbarCopy] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SelectionToolbarPrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SelectionToolbarQuote] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SelectionToolbarRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SmartMessageText] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [Source] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [SourceIcon] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [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)
+- [ToolFallbackContent] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolFallbackError] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolFallbackResult] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolFallbackRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolFallbackTrigger] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolGroup] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolGroupContent] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolGroupRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ToolGroupTrigger] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [TooltipIconButton] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [UserActionBar] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [UserMessage] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [UserMessageAttachments] — component [docs](https://ads.actioneer.dev/#/demo/ask)
+- [ChatModelAdapter] — TypeScript type
+- [ContextNode] — TypeScript type
+- [CreateDirectiveTextOptions] — TypeScript type
+- [DeepResearchState] — TypeScript type
+- [FileRootProps] — TypeScript type
+- [FollowUpSuggestionProps] — TypeScript type
+- [ImageActionsProps] — TypeScript type
+- [ImageRootProps] — TypeScript type
+- [LocalRuntimeOptions] — TypeScript type
+- [SourceProps] — TypeScript type
+- [StageUsageHandler] — TypeScript type
+- [ThreadComponents] — TypeScript type
+- [ThreadGroupPart] — TypeScript type
+- [ThreadMessageLike] — TypeScript type
+- [ThreadProps] — TypeScript type
+- [ToolCallMessagePartProps] — TypeScript type
+- [ToolFallbackRootProps] — TypeScript type
+- [ToolGroupRootProps] — TypeScript type
+- [TooltipIconButtonProps] — TypeScript type
+- [useAssistantRuntime] — React hook
+- [useAuiState] — React hook
+- [useLocalRuntime] — React hook
+- [ActioneerFileAttachmentAdapter] — utility
+- [ComposerAddContext] — utility
+- [CompositeAttachmentAdapter] — utility
+- [ContextAttachmentAdapter] — utility
+- [createDirectiveText] — utility
+- [fileVariants] — utility
+- [formatFileSize] — utility
+- [getBase64Size] — utility
+- [getMimeTypeIcon] — utility
+- [HarnessAttachmentAdapter] — utility
+- [imageVariants] — utility
+- [isNewChatView] — utility
+- [makeAssistantToolUI] — utility
+- [SimpleImageAttachmentAdapter] — utility
+- [sourceVariants] — utility
+- [ThreadComponentsContext] — utility
+- [toolGroupVariants] — utility