@actioneer/ads 0.2.0 → 0.2.2

package/bin/ads-init.mjs

@@ -17,14 +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 { pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
 
 const PKG = "@actioneer/ads";
 const STYLE_IMPORT = `@import "${PKG}/styles.css";`;
@@ -39,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
@@ -50,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 = [];
@@ -59,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"`.
@@ -214,6 +254,15 @@ const CANDIDATE_CSS = [
 ];
 const CANDIDATE_LAYOUT = ["app/layout.tsx", "src/app/layout.tsx", "app/layout.jsx", "src/app/layout.jsx"];
 
+// The load-bearing anchor: ADS styles must import into the SAME CSS graph as
+// tailwindcss, right after it (styles.css before tailwindcss leaves @theme
+// inert). Detection keys off this so a non-standard stylesheet is still found.
+const TAILWIND_IMPORT_RE = /@import\s+["']tailwindcss["']/;
+// Dirs the stylesheet scan never descends into.
+const SCAN_IGNORE = new Set([
+  "node_modules", ".git", ".next", "dist", "dist-lib", "build", "out", "coverage", ".turbo", ".vercel", ".cache",
+]);
+
 function toPosix(p) {
   return p.split(path.sep).join("/");
 }
@@ -221,6 +270,81 @@ function fileExistsInState(state, relPosix) {
   return state._existing?.has(relPosix) ?? false;
 }
 
+/**
+ * Find the global stylesheet to wire ADS styles into. Because the import order
+ * is load-bearing, detection PREFERS the stylesheet that already imports
+ * tailwindcss — first among the conventional locations, then ANYWHERE in the
+ * project (bounded scan) so a non-standard path (e.g. `src/index.css`,
+ * `app/tailwind.css`) is auto-wired instead of degrading to a hand-edit note.
+ * Falls back to the first conventional file that exists (→ manual, with anchor
+ * guidance), else null.
+ * @returns {{path: string|null, content: string|null}}
+ */
+export function detectGlobalCss(cwd) {
+  const read = (rel) => {
+    const abs = path.join(cwd, rel);
+    return fs.existsSync(abs) ? fs.readFileSync(abs, "utf8") : null;
+  };
+  // 1. Conventional location that already imports tailwindcss (the anchor).
+  for (const p of CANDIDATE_CSS) {
+    const c = read(p);
+    if (c != null && TAILWIND_IMPORT_RE.test(c)) return { path: p, content: c };
+  }
+  // 2. Any .css in the project importing tailwindcss (covers non-standard paths).
+  const scanned = scanForTailwindCss(cwd);
+  if (scanned) return scanned;
+  // 3. A conventional file exists but has no tailwindcss anchor → manual path.
+  for (const p of CANDIDATE_CSS) {
+    const c = read(p);
+    if (c != null) return { path: p, content: c };
+  }
+  return { path: null, content: null };
+}
+
+/** Bounded walk for the shallowest .css that imports tailwindcss. */
+function scanForTailwindCss(cwd, maxDepth = 5) {
+  const hits = [];
+  const walk = (rel, depth) => {
+    if (depth > maxDepth) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(path.join(cwd, rel || "."), { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (e.name.startsWith(".")) continue;
+      const childRel = rel ? `${rel}/${e.name}` : e.name;
+      if (e.isDirectory()) {
+        if (!SCAN_IGNORE.has(e.name)) walk(childRel, depth + 1);
+      } else if (e.name.endsWith(".css")) {
+        let c;
+        try {
+          c = fs.readFileSync(path.join(cwd, childRel), "utf8");
+        } catch {
+          continue;
+        }
+        if (TAILWIND_IMPORT_RE.test(c)) hits.push({ path: toPosix(childRel), content: c });
+      }
+    }
+  };
+  walk("", 0);
+  // Shallowest path wins (the app entry over a nested one); stable tiebreak.
+  hits.sort((a, b) => a.path.split("/").length - b.path.split("/").length || a.path.localeCompare(b.path));
+  return hits[0] ?? null;
+}
+
+/**
+ * Re-check the load-bearing outcome after init: is `@import "…/styles.css"`
+ * actually present in the detected global stylesheet? Drives the end-of-run
+ * summary so a missed/deferred styles import can't scroll past unnoticed.
+ * @returns {{ok: boolean, path: string|null}}
+ */
+export function verifyStylesWired(cwd) {
+  const css = detectGlobalCss(cwd);
+  return { ok: css.content != null && css.content.includes(STYLE_IMPORT), path: css.path };
+}
+
 function readRepoState(cwd) {
   const read = (rel) => {
     const abs = path.join(cwd, rel);
@@ -230,7 +354,13 @@ function readRepoState(cwd) {
   const pkg = pkgRaw ? JSON.parse(pkgRaw) : {};
   const dependencies = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
 
-  const globalCssPath = CANDIDATE_CSS.find((p) => fs.existsSync(path.join(cwd, p))) ?? null;
+  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 css = detectGlobalCss(cwd);
   const layoutPath = CANDIDATE_LAYOUT.find((p) => fs.existsSync(path.join(cwd, p))) ?? null;
 
   const _existing = new Set();
@@ -240,12 +370,13 @@ function readRepoState(cwd) {
 
   return {
     dependencies,
-    globalCssPath,
-    globalCssContent: globalCssPath ? read(globalCssPath) : null,
+    globalCssPath: css.path,
+    globalCssContent: css.content,
     layoutPath,
     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,
   };
 }
@@ -254,8 +385,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": {
@@ -288,6 +420,47 @@ function applyEdit(cwd, edit) {
   }
 }
 
+/**
+ * End-of-run summary. The styles import carries EVERY token (colors, type, and
+ * the animation curves/speeds), so its outcome gets promoted out of the
+ * scrolling edit log into a verified ✓ / ⚠ block that can't be missed — plus any
+ * remaining manual steps and the import hint.
+ */
+function printSummary(cwd, edits) {
+  const wired = verifyStylesWired(cwd);
+  const bar = "─".repeat(70);
+
+  console.log("");
+  if (wired.ok) {
+    console.log(`✓ ADS styles wired — \`${STYLE_IMPORT}\` is in ${wired.path}.`);
+    console.log(`  That one import carries every ADS token: colors, typography, and the`);
+    console.log(`  animation curves/speeds.`);
+  } else {
+    console.log(bar);
+    console.log(`⚠  ACTION REQUIRED — ADS styles are NOT imported yet.`);
+    console.log(``);
+    console.log(`   Nothing will be themed until you add this to your global stylesheet,`);
+    console.log(`   immediately AFTER the tailwindcss import (the order is load-bearing):`);
+    console.log(``);
+    console.log(`       @import "tailwindcss";`);
+    console.log(`       ${STYLE_IMPORT}`);
+    console.log(``);
+    console.log(`   Without it NO tokens load — colors, typography, and every animation`);
+    console.log(`   curve/speed will be missing.`);
+    console.log(bar);
+  }
+
+  // Surface any non-styles manual step (e.g. the layout <Providers> wrap) too —
+  // the styles step is already covered by the block above.
+  const otherManual = edits.filter((e) => e.type === "manual" && !/styles\.css/.test(e.title));
+  if (otherManual.length) {
+    console.log(`\n  Remaining manual step(s):`);
+    for (const m of otherManual) console.log(`    • ${m.title}`);
+  }
+
+  console.log(`\n  Then import components: \`import { Button } from "${PKG}";\``);
+}
+
 function main() {
   const cmd = process.argv[2];
   const cwd = process.cwd();
@@ -301,19 +474,36 @@ function main() {
 
   if (edits.length === 0) {
     console.log(`${PKG} init: nothing to do — already configured.`);
-    return;
+  } else {
+    console.log(`${PKG} init: applying ${edits.length} edit(s)…`);
+    for (const edit of edits) applyEdit(cwd, edit);
+    console.log(`\n${PKG} init: done.`);
   }
 
-  console.log(`${PKG} init: applying ${edits.length} edit(s)…`);
-  for (const edit of edits) applyEdit(cwd, edit);
-  console.log(`\n${PKG} init: done. Import components with \`import { Button } from "${PKG}";\``);
+  // Always verify + summarize the load-bearing styles import (fixes #2: a
+  // deferred/missed styles import can no longer scroll past unnoticed).
+  printSummary(cwd, edits);
+}
+
+/**
+ * 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;
+  }
 }
 
-// Only run the applier when invoked as a CLI (keeps planInit importable/pure).
-// Compare via pathToFileURL so an install path with spaces or non-ASCII (e.g.
-// "/Users/My Name/…") still matches — import.meta.url is percent-encoded, so a
-// raw `file://${process.argv[1]}` concat would silently fail to match and the
-// CLI would no-op.
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+if (invokedAsCli()) {
   main();
 }

package/llms.txt

@@ -622,3 +622,132 @@ ADS targets landscape tablet (1024) → laptop (1440) → wide display (1920+);
 - [VoiceVariant] — TypeScript type
 - [useReasoning] — React hook
 - [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