@assistant-ui/mcp-docs-server 0.1.36 → 0.1.38

package/src/utils/paths.ts

@@ -66,6 +66,28 @@ export async function getAvailablePaths(): Promise<string[]> {
   return paths.sort();
 }
 
+export async function getAvailableDocFiles(): Promise<string[]> {
+  const files: string[] = [];
+
+  async function scanDirectory(dir: string, prefix = ""): Promise<void> {
+    const { directories, files: dirFiles } = await listDirContents(dir);
+
+    for (const file of dirFiles) {
+      if (extname(file) !== MDX_EXTENSION) continue;
+      const name = file.replace(MDX_EXTENSION, "");
+      files.push(prefix ? `${prefix}/${name}` : name);
+    }
+
+    for (const subdir of directories) {
+      const newPrefix = prefix ? `${prefix}/${subdir}` : subdir;
+      await scanDirectory(join(dir, subdir), newPrefix);
+    }
+  }
+
+  await scanDirectory(DOCS_PATH);
+  return files.sort();
+}
+
 export function findNearestPaths(
   requestedPath: string,
   availablePaths: string[],

package/src/utils/search.ts

@@ -0,0 +1,131 @@
+import { join } from "node:path";
+import { DOCS_PATH, MDX_EXTENSION } from "../constants.js";
+import { getAvailablePaths, pathExists } from "./paths.js";
+import { readMDXFile } from "./mdx.js";
+
+const SCORE_WEIGHTS = {
+  FULL_QUERY: { title: 10, path: 8, description: 5 },
+  TOKEN: { title: 3, path: 2, description: 1, content: 0.5 },
+} as const;
+
+interface IndexEntry {
+  path: string;
+  title: string;
+  description: string;
+  content: string;
+  excerpt: string;
+}
+
+export interface SearchResult {
+  path: string;
+  title: string;
+  snippet: string;
+}
+
+let indexPromise: Promise<IndexEntry[]> | null = null;
+
+function deriveTitle(
+  path: string,
+  frontmatter: Record<string, unknown>,
+): string {
+  const fmTitle = frontmatter["title"];
+  if (typeof fmTitle === "string" && fmTitle.trim()) return fmTitle;
+  return path.split("/").pop() ?? path;
+}
+
+async function buildIndex(): Promise<IndexEntry[]> {
+  const paths = await getAvailablePaths();
+  const entries = await Promise.all(
+    paths.map(async (path): Promise<IndexEntry | null> => {
+      const filePath = join(DOCS_PATH, `${path}${MDX_EXTENSION}`);
+      if (!(await pathExists(filePath))) return null;
+      const mdx = await readMDXFile(filePath);
+      if (!mdx) return null;
+      const description = mdx.frontmatter["description"];
+      return {
+        path,
+        title: deriveTitle(path, mdx.frontmatter),
+        description: typeof description === "string" ? description : "",
+        content: mdx.content,
+        excerpt: mdx.excerpt ?? "",
+      };
+    }),
+  );
+  return entries.filter((entry): entry is IndexEntry => entry !== null);
+}
+
+function getIndex(): Promise<IndexEntry[]> {
+  if (!indexPromise) {
+    indexPromise = buildIndex().catch((error) => {
+      indexPromise = null;
+      throw error;
+    });
+  }
+  return indexPromise;
+}
+
+function makeSnippet(
+  content: string,
+  tokens: string[],
+  excerpt: string,
+): string {
+  const lower = content.toLowerCase();
+  for (const token of tokens) {
+    const idx = lower.indexOf(token);
+    if (idx >= 0) {
+      const start = Math.max(0, idx - 60);
+      const end = Math.min(content.length, idx + token.length + 100);
+      const slice = content.slice(start, end).replace(/\s+/g, " ").trim();
+      return `${start > 0 ? "…" : ""}${slice}${end < content.length ? "…" : ""}`;
+    }
+  }
+  if (excerpt) return excerpt.slice(0, 160);
+  const firstLine = content.split("\n").find((line) => line.trim());
+  return firstLine ? firstLine.replace(/^#+\s*/, "").slice(0, 160) : "";
+}
+
+function scoreEntry(
+  entry: IndexEntry,
+  query: string,
+  tokens: string[],
+): number {
+  const title = entry.title.toLowerCase();
+  const path = entry.path.toLowerCase();
+  const description = entry.description.toLowerCase();
+  const content = entry.content.toLowerCase();
+
+  let score = 0;
+  if (title.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.title;
+  if (path.includes(query)) score += SCORE_WEIGHTS.FULL_QUERY.path;
+  if (description.includes(query))
+    score += SCORE_WEIGHTS.FULL_QUERY.description;
+
+  for (const token of tokens) {
+    if (title.includes(token)) score += SCORE_WEIGHTS.TOKEN.title;
+    if (path.includes(token)) score += SCORE_WEIGHTS.TOKEN.path;
+    if (description.includes(token)) score += SCORE_WEIGHTS.TOKEN.description;
+    if (content.includes(token)) score += SCORE_WEIGHTS.TOKEN.content;
+  }
+  return score;
+}
+
+export async function searchDocs(
+  query: string,
+  limit = 10,
+): Promise<SearchResult[]> {
+  const normalized = query.trim().toLowerCase();
+  if (!normalized) return [];
+  const tokens = normalized.split(/\s+/).filter(Boolean);
+
+  const index = await getIndex();
+  return index
+    .map((entry) => ({ entry, score: scoreEntry(entry, normalized, tokens) }))
+    .filter((scored) => scored.score > 0)
+    .sort((a, b) => b.score - a.score)
+    .slice(0, limit)
+    .map(({ entry }) => ({
+      path: entry.path,
+      title: entry.title,
+      snippet: makeSnippet(entry.content, tokens, entry.excerpt),
+    }));
+}

package/.docs/raw/blog/2024-07-29-hello/index.mdx

@@ -1,64 +0,0 @@
----
-title: Hello, assistant-ui
-description: assistant-ui is an open-source AI chat component for React.
-author: Simon Farshid
-date: 2024-07-29T12:00:00
----
-
-import Image from "next/image";
-import { TestimonialContainer } from "@/components/home/testimonials/testimonials";
-import { BLOG_TESTIMONIALS } from "@/components/home/testimonials/data";
-import npmDownloads from "./npm-downloads.png";
-import assistantUi from "./assistant-ui-screenshot.png";
-
-After spending the last two years building Gen-AI prototypes and products, I realized that all software will soon have a natural language interface. OpenAI's ChatGPT sets the quality bar high and I wanted to have a similar UX in my own apps. No solution on the market came anywhere close, so I built assistant-ui.
-
-assistant-ui is an open-source, embeddable, customizable AI chat component for React web apps. You can use it to build GPT wrappers, in-app copilots, or agentic systems. It supports rich content (markdown, code highlighting, charts, tables), generative UI, message editing, ..., across all the major model providers.
-
-<Image
-  src={assistantUi}
-  alt="screenshot of assistant-ui"
-  width={398}
-  height={498}
-  className="mx-auto rounded-xl border drop-shadow"
-/>
-
-Earlier last month, I released the project to the world. The feedback from early adopters has been overwhelmingly positive:
-
-<div className="not-prose mx-auto max-w-md">
-  <TestimonialContainer testimonials={BLOG_TESTIMONIALS} />
-</div>
-
-It didn't take long for developers to start building with assistant-ui. Here are some of my favorite products from the community:
-
-- [Helicone](https://helicone.ai/) - open-source LLM observability platform
-- [screenpipe](https://screenpi.pe/) - AI to remember everything you see, say or hear
-- [myresume.guru](http://myresume.guru) - AI resume optimizer to land your dream job
-
-With 250+ stars on [GitHub](https://github.com/assistant-ui/assistant-ui) and over 1k [npm](https://www.npmjs.com/package/@assistant-ui/react) weekly downloads, we got a vibrant growing community of developers who care about the user experience.
-
-<Image
-  src={npmDownloads}
-  alt="graph showing 1355 weekly npm downloads"
-  width={381}
-  height={94}
-  className="mx-auto dark:hue-rotate-180 dark:invert"
-/>
-
-I want to thank the following contributors who got the project to where it is today:
-
-- [@m13v](https://github.com/m13v) for contributing two examples and several how-to videos
-- [@okisdev](https://github.com/okisdev) for multiple bugfixes
-- [@Rajaniraiyn](https://github.com/Rajaniraiyn) for improving streaming support for REST APIs
-- @ccbkai for integrating Chrome's `window.ai` with assistant-ui
-- [@stingfeng](https://github.com/stingfeng/dify-extensions) for building a [Dify](https://dify.ai) integration
-- [@Ephibbs](https://github.com/Ephibbs/flowtoken) for building a Perplexity-style text streaming library ([Demo](https://assistant-ui-flowtoken-demo.vercel.app/))
-- … and so many others
-
-assistant-ui builds on top of [Radix UI](https://www.radix-ui.com/), [Tailwind](https://tailwindcss.com/), [shadcn/ui](https://ui.shadcn.com/), [Vercel AI SDK](https://sdk.vercel.ai/docs/introduction) and other amazing open-source projects.
-
-Over the coming month, I'll be rolling out multimodal support, so you can use your voice and upload images. There's so much more in the pipeline that I can't wait to unveil!
-
-Today, several companies like [Helicone (YC W23)](https://x.com/justinstorre/status/1816849882612904156) are using assistant-ui to power a core part of their product. If your company wants to do the same, please [get in touch](https://cal.com/simon-farshid/assistant-ui).
-
-If you're building conversational AI, join us on [Discord](https://discord.gg/S9dwgCNEFs). If you're technical and want to shape how we interact with AIs of the future, [send me an email](mailto:simon@assistant-ui.com).

package/.docs/raw/blog/2024-09-11/index.mdx

@@ -1,10 +0,0 @@
----
-title: Build conversational AI agents with LangGraph and assistant-ui
-description: Announcing our collaboration with LangChain
-author: Harrison Chase
-date: 2024-09-11T12:00:00
----
-
-import { Redirect } from "./redirect";
-
-<Redirect />

package/.docs/raw/blog/2024-12-15/index.mdx

@@ -1,10 +0,0 @@
----
-title: Announcing github-assistant
-description: github-assistant answers questions about your GitHub repositories.
-author: Amir Zohrenejad
-date: 2024-12-15T12:00:00
----
-
-import { Redirect } from "./redirect";
-
-<Redirect />

package/.docs/raw/blog/2025-01-31-changelog/index.mdx

@@ -1,127 +0,0 @@
----
-title: January 2025 Changelog
-description: shadcn/ui, Thread Management, Improvements to AI SDK and LangGraph support
-author: Simon Farshid
-date: 2025-01-31T12:00:00
----
-
-<Callout emoji="🎉">
-  This is the first edition of our changelog. We post these updates on a monthly
-  basis. If you want more frequent updates about our new features, join our
-  Discord where we have a `#changelog` channel that is updated on a daily basis.
-</Callout>
-
-## Summary
-
-In January, we shipped 36 new versions of our package `@assistant-ui/react`. We also crossed 10k weekly downloads on npm for the first time. 🎉
-
-## shadcn/ui CLI support
-
-You can now install all components using the shadcn CLI, e.g.
-
-```sh
-npx shadcn@latest add "https://r.assistant-ui.com/thread"
-```
-
-We began a migration towards distributing our components as unstyled primitives and using the shadcn CLI to drop styles in your project.
-
-## Styled components moved to @assistant-ui/react-ui
-
-All styled components (Thread, ThreadList, AssistantModal, makeMarkdownText, etc.) have been moved to a new package, `@assistant-ui/ui`.
-
-To ease the migration, we added a migration codemod:
-
-```sh
-npx assistant-ui upgrade
-```
-
-This will update your codebase to use the new package. This new package remains supported, however, based on the learnings from existing users, we recommend all new projects to use our shadcn/ui CLI instead.
-
-## Customizing the max-width of the Thread
-
-You can now customize the max-width of the thread via `--aui-thread-max-width` CSS variable.
-
-## Thread Management
-
-One of our main focus areas in this month was on the new Thread Management API. The new ThreadList API is available under `runtime.threads`. It allows you to create, switch to, rename, archive, and delete threads.
-
-We shipped a `<ThreadList />` component which gives the user the UI to manage their threads.
-
-We also shipped a few hooks `useThreadListItem()`, `useThreadListItemRuntime()`, `useRemoteThreadListRuntime()` and `useCloudThreadListRuntime()`.
-
-## Assistant Cloud
-
-We rolled out the new Assistant Cloud service to early users. This is a managed service for persistence, chat history, and thread management.
-Our runtimes are being upgraded to support Assistant Cloud natively by letting you pass a `cloud` object to the runtime hook.
-
-Keep an eye out for the public announcement of Assistant Cloud in a few days.
-
-## Improvements to our LangGraph Integration
-
-- We now have full support for LangGraph's `interrupt()`/`Command` API. You can check out the new example repository [here](https://github.com/assistant-ui/assistant-ui-langgraph-interrupt).
-- We now also support starting LangGraph runs without a user message (based on button input or other events).
-- Cancellation of runs is now supported via an `abortSignal` being passed to the LangGraph runtime adapter.
-
-## Improvements to our AI SDK Integration
-
-We now give you access to annotations and data packets in the assistant message:
-
-```tsx
-type AssistantMessage = {
-  metadata: {
-    unstable_annotations: [...],
-    unstable_data: [...],
-  }
-}
-```
-
-## AI SDK recommended for new projects
-
-For new projects, we recommend using the AI SDK integration. Previously, we recommended our custom SDK called `useEdgeRuntime`.  
-With our improved AI SDK integration, we believe it is time to recommend AI SDK for new projects, giving you access to the AI SDK ecosystem.
-
-The edge runtime remains maintained and supported for existing projects.
-
-## Misc
-
-- **Refactors & API Enhancements**:
-
-  - Renamed `ModelConfig` to `ModelContext`.
-  - Moved `switchToThread / switchToNewThread` under `runtime.threads`.
-  - Deprecated `UIContentPart`.
-  - `ToolCallContentPart.args` is now a `JSONObject`.
-  - `MessagePrimitive.tools.Override` introduced.
-  - Added `AppendMessage.sourceId` to provide better tracking.
-  - Reverse order of threads in `useRemoteThreadListRuntime` for better visibility.
-  - Added `threads.getById` and `threads.main` APIs.
-  - Introduced `AssistantCloudThreadHistoryAdapter` to handle cloud-based thread history.
-  - Auto-injection of history adapter in the local runtime.
-  - Tool call `id` + `args` are now optional in `ThreadMessageLike`.
-  - Added `ThreadListPrimitive.Root`.
-  - `ComposerRuntime.clearAttachments` API added.
-  - Improved input support for IME keyboards (e.g., Chinese, Japanese, Korean).
-  - Moved repository to a new GitHub organization (`assistant-ui/assistant-ui`).
-
-- **External Store & Data Handling**:
-
-  - Enhanced `ExternalStoreAdapter` to support metadata and attachments.
-  - Renamed `getExternalStoreMessage` to `getExternalStoreMessages`.
-  - Tool call `args` streaming support in our Python SDK.
-
-- **User Interface & Styling**:
-
-  - Styled UI assistant message footer.
-  - Improved attachment filename handling to prevent overflow.
-  - Renamed CSS class to `aui-thread-welcome-suggestions`.
-
-- **Performance Optimizations**:
-
-  - Memoized `MessageRepository.getMessages()` for better efficiency.
-  - Marked `ChatAdapter` types as readonly.
-
-- **Bug Fixes**:
-
-  - Fixed event subscription issues in thread lists.
-  - Fixed import errors in React server environments.
-  - Prevented excessive classes being included via TailwindCSS.
-  - Fixed AI SDK annotation packet errors.

package/.docs/raw/blog/2026-03-launch-week/index.mdx

@@ -1,258 +0,0 @@
----
-title: "Launch Week: assistant-ui goes multi-platform"
-description: "React Native, terminal UIs, and more — assistant-ui is no longer just for the web."
-author: Simon Farshid
-date: 2026-03-09T12:00:00
----
-
-import Image from "next/image";
-
-This week, we're shipping one major feature every day. The theme: **assistant-ui everywhere**.
-
-For two years, assistant-ui has been the go-to library for building AI chat on the web. Starting this week, that changes. Same runtime, same adapters, same developer experience — now on every platform your users are.
-
----
-
-## Day 1 — React Native
-
-**Build AI chat for iOS and Android.**
-
-We're launching `@assistant-ui/react-native` — native React Native bindings that bring the full assistant-ui experience to mobile.
-
-Everything you know from the web version carries over:
-
-- **Same runtime, same adapters.** Your `ChatModelAdapter`, AI SDK integration, or LangGraph setup works out of the box. No rewrites.
-- **Native primitives.** `View`, `Pressable`, `Text`, `FlatList` — not web views, not wrappers. Real native components.
-- **Full feature set.** Streaming, tool calls, message branching, thread management, attachments — all there.
-
-Get started in one command:
-
-```sh
-npx assistant-ui@latest create --example with-expo my-chat-app
-```
-
-Or add it to an existing Expo project:
-
-```sh
-npx expo install @assistant-ui/react-native @assistant-ui/react-ai-sdk
-```
-
-The API mirrors the web version closely. If you've built with `@assistant-ui/react`, you already know how to use it.
-
-[Read the docs →](/docs/react-native)
-
----
-
-## Day 2 — React Ink (Terminal UI)
-
-**Build AI chat for the terminal.**
-
-We're launching `@assistant-ui/react-ink` — terminal UI bindings powered by [Ink](https://github.com/vadimdemedes/ink), the React renderer for CLIs.
-
-Build rich, interactive AI chat interfaces that run in any terminal:
-
-- **Composable primitives.** `ThreadRoot`, `ComposerInput`, `MessageContent` — the same component model, adapted for the terminal.
-- **Markdown rendering.** Ship with `@assistant-ui/react-ink-markdown` for formatted headings, code blocks with syntax highlighting, tables, and lists — all in your terminal.
-- **Code diff rendering.** Built-in `DiffView` component and composable `DiffPrimitive` components for displaying code diffs with syntax highlighting, line numbers, and context folding.
-- **Tool calls with live feedback.** Built-in `ToolFallback` component shows spinners and formatted JSON output while tools execute.
-- **Shared backend.** Same adapters, same runtime core. Switch platforms without touching your backend code.
-
-Get started:
-
-```sh
-npx assistant-ui@latest create --ink my-chat-app
-```
-
-[Read the docs →](/docs/ink)
-
----
-
-## Day 3 — Assistant Cloud Redesign
-
-**A new dashboard for managing your AI assistants at scale.**
-
-We've completely redesigned [Assistant Cloud](https://cloud.assistant-ui.com), the hosted backend for assistant-ui. Thread persistence, analytics, user management, and more, all in one place.
-
-<Image
-  src="/images/cloud-dashboard.png"
-  alt="Assistant Cloud dashboard showing analytics, threads, and run tracking"
-  width={1200}
-  height={675}
-  className="mx-auto rounded-xl border drop-shadow"
-/>
-
-### What is Assistant Cloud?
-
-Assistant Cloud gives your assistant-ui app a production-ready backend. Drop in a few lines of config and get:
-
-- **Thread persistence.** Conversations survive page refreshes. Users can pick up where they left off.
-- **Thread list.** A ChatGPT-style sidebar, powered by your data — no extra backend work.
-- **Auto-generated titles.** Every thread gets a title, automatically.
-- **User authorization.** Works with Clerk, Auth0, Supabase, Firebase, or anonymous mode for demos.
-
-### What's new in the redesign
-
-The new dashboard at `cloud.assistant-ui.com` is a full control center for your AI deployments:
-
-- **Analytics dashboard.** Total cost, token usage, run count, average duration — with model distribution charts and usage trends over time.
-- **Thread browser.** Search and inspect every conversation. View full message history, metadata, and timestamps.
-- **User analytics.** Per-user metrics: runs, threads created, tokens consumed, costs incurred.
-- **Run tracking.** Every LLM invocation logged with model, provider, cost, input/output tokens, cached tokens, reasoning tokens, and duration.
-- **Assistant configuration.** Create multiple assistants with different models, system prompts, temperature, and top-p settings.
-- **LLM provider management.** Configure OpenAI, Anthropic, Google, and other providers — with encrypted credential storage.
-- **API key management.** Generate, track, and revoke project API keys.
-- **Auth rules.** Configure JWT validation with JWKS URL, audience, and issuer settings.
-
-### Getting started
-
-Add thread persistence to your existing assistant-ui app:
-
-```sh
-npx assistant-ui@latest cloud
-```
-
-Or integrate directly with the AI SDK using `useCloudChat`:
-
-```sh
-npm install @assistant-ui/cloud-ai-sdk @ai-sdk/react ai
-```
-
-Works with any assistant-ui runtime — AI SDK, LangGraph, or custom backends. No migration required.
-
-[Read the docs →](/docs/cloud) 
-
-[Sign up here →](https://cloud.assistant-ui.com)
-
----
-
-## Day 4 — <span className="shimmer">tw-shimmer</span>
-
-**Beautiful shimmer effects for Tailwind CSS v4. Zero dependencies, pure CSS.**
-
-We're launching [`tw-shimmer`](https://www.npmjs.com/package/tw-shimmer) — a Tailwind CSS v4 plugin that adds polished shimmer animations for both text and skeleton loaders. No JavaScript runtime, no dependencies — just add a class and go.
-
-- **Sine-eased gradients.** 17 carefully calculated gradient stops following a sine ease-in-out curve. No banding, no harsh edges — just smooth, organic highlights.
-- **OKLCH color mixing.** Perceptually uniform color transitions that look great in any color scheme.
-- **Text + Background.** Shimmer text labels or skeleton placeholders with the same API.
-- **Auto-sizing.** CSS container queries automatically derive speed and spread from container width — no JavaScript measurement needed.
-- **Fully customizable.** Speed, spread, angle, color, duration, and repeat delay — all controllable via Tailwind utilities or CSS variables.
-
-Install and add to your CSS:
-
-```sh
-npm install tw-shimmer
-```
-
-```css title="app/globals.css"
-@import "tailwindcss";
-@import "tw-shimmer";
-```
-
-Then use it:
-
-```html
-<!-- Text shimmer -->
-<span class="shimmer text-foreground/60">Loading...</span>
-
-<!-- Skeleton loader -->
-<div class="shimmer-container flex gap-3">
-  <div class="shimmer-bg bg-muted size-12 rounded-full" />
-  <div class="flex-1 space-y-2">
-    <div class="shimmer-bg bg-muted h-4 w-1/4 rounded" />
-    <div class="shimmer-bg bg-muted h-4 w-full rounded" />
-  </div>
-</div>
-```
-
-[See the interactive demo →](/tw-shimmer)
-
-[Read the docs →](/docs/utilities/tw-shimmer)
-
----
-
-## Day 5 — Cloud AI SDK
-
-**Add cloud persistence to any AI SDK app. Just change your import.**
-
-We're launching `@assistant-ui/cloud-ai-sdk` — a standalone package that adds full thread persistence and management to any Vercel AI SDK application with a single hook change. No providers, no context, no runtime objects.
-
-### Before
-
-```tsx
-import { useChat } from "@ai-sdk/react";
-
-const { messages, sendMessage } = useChat();
-```
-
-### After
-
-```tsx
-import { useCloudChat } from "@assistant-ui/cloud-ai-sdk";
-
-const { messages, sendMessage, threads } = useCloudChat();
-```
-
-That's it. One import change gives you:
-
-- **Automatic thread creation.** Threads are created on the first message — no manual setup.
-- **Full message persistence.** Conversations survive page refreshes. Users pick up where they left off.
-- **Built-in thread list.** `threads.threads` gives you a ChatGPT-style thread sidebar, sorted by recency.
-- **Auto-generated titles.** Every thread gets an AI-generated title after the first response.
-- **Zero config.** Set one env var (`NEXT_PUBLIC_ASSISTANT_BASE_URL`) and you're done.
-- **Works with any UI.** Keep your existing components — `useCloudChat` returns the same interface as `useChat`.
-
-The package exports just two hooks (`useCloudChat` and `useThreads`) and four types. It works independently of assistant-ui's runtime and primitives — any React UI works.
-
-Get started:
-
-```sh
-npm install @assistant-ui/cloud-ai-sdk @ai-sdk/react ai
-```
-
-[Read the docs →](/docs/cloud/ai-sdk)
-
-[See the launch page →](/cloud-ai-sdk)
-
----
-
-## Day 6 — Heat Graph
-
-**GitHub-style activity heatmaps for React. Headless, composable, fully customizable.**
-
-We're launching [`heat-graph`](https://www.npmjs.com/package/heat-graph) — a set of Radix-style compound components for building activity heatmap graphs. No styling opinions, no dependencies on charting libraries — just composable primitives you fully control.
-
-- **Radix-style composable.** `Root`, `Grid`, `Cell`, `Legend`, `Tooltip` — pick the pieces you need and compose them however you want.
-- **Fully headless.** Zero styling opinions. Every element is a plain div you can style with CSS, Tailwind, or any framework.
-- **Tooltip built-in.** Hover tooltips powered by Radix Popper for pixel-perfect positioning, no extra deps.
-- **Custom bucketing.** Plug in your own classification function to control how counts map to color levels.
-- **Localizable.** Month and day labels expose raw values — format with the included English helpers or `Intl.DateTimeFormat` for any locale.
-
-Install it:
-
-```sh
-npm install heat-graph
-```
-
-Or add it via shadcn:
-
-```sh
-npx shadcn@latest add https://r.assistant-ui.com/heat-graph
-```
-
-[See the interactive demo →](/heat-graph)
-
-[Read the docs →](/docs/utilities/heat-graph)
-
----
-
-## One runtime, every platform
-
-The big picture: assistant-ui is now a **universal AI chat framework**. Web, mobile, terminal — one codebase for your backend, one set of adapters, one way to register tools. The only thing that changes is the UI layer.
-
-```
-@assistant-ui/react          → Web (React + Radix UI)
-@assistant-ui/react-native   → Mobile (React Native)
-@assistant-ui/react-ink      → Terminal (Ink)
-```
-
-We'll be updating this post throughout the week as we ship new announcements. Follow [@assistant-ui](https://x.com/assistantui) for daily updates or join our [Discord](https://discord.gg/S9dwgCNEFs) for early access.