@assistant-ui/mcp-docs-server 0.1.25 → 0.1.27

package/.docs/organized/code-examples/with-react-ink.md

@@ -17,13 +17,13 @@
     "@assistant-ui/react-ink": "workspace:*",
     "@assistant-ui/react-ink-markdown": "workspace:*",
     "ink": "^6.8.0",
-    "react": "^19.1.0"
+    "react": "^19.2.4"
   },
   "devDependencies": {
     "@types/react": "^19.2.14",
-    "esbuild": "^0.27.4",
+    "esbuild": "^0.28.0",
     "tsx": "^4.21.0",
-    "typescript": "~5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

package/.docs/organized/code-examples/with-react-router.md

@@ -772,30 +772,30 @@ export default function Home() {
   "dependencies": {
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
-    "@react-router/node": "^7.13.1",
-    "@react-router/serve": "^7.13.1",
+    "@react-router/node": "^7.14.0",
+    "@react-router/serve": "^7.14.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "eventsource-parser": "^3.0.6",
-    "isbot": "^5.1.36",
-    "lucide-react": "^0.577.0",
-    "openai": "^6.29.0",
+    "isbot": "^5.1.37",
+    "lucide-react": "^1.7.0",
+    "openai": "^6.33.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "react-router": "^7.13.1",
+    "react-router": "^7.14.0",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
-    "@react-router/dev": "^7.13.1",
-    "@tailwindcss/vite": "^4.2.1",
+    "@react-router/dev": "^7.14.0",
+    "@tailwindcss/vite": "^4.2.2",
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.0",
+    "typescript": "5.9.3",
+    "vite": "^8.0.3",
     "vite-tsconfig-paths": "^6.1.1"
   }
 }

package/.docs/organized/code-examples/with-store.md

@@ -488,20 +488,20 @@ export default nextConfig;
   "dependencies": {
     "@assistant-ui/store": "workspace:*",
     "@assistant-ui/tap": "workspace:*",
-    "next": "^16.1.6",
+    "next": "^16.2.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
+    "@tailwindcss/postcss": "^4.2.2",
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 
@@ -634,7 +634,7 @@ useAuiEvent("*", (data) => {
 
 ## Learn More
 
-- [@assistant-ui/store Documentation](../store/README.md)
+- [@assistant-ui/store Documentation](https://github.com/assistant-ui/assistant-ui/tree/main/packages/store)
 - [Next.js Documentation](https://nextjs.org/docs)
 
 ```
@@ -645,7 +645,12 @@ useAuiEvent("*", (data) => {
 {
   "extends": "@assistant-ui/x-buildutils/ts/next",
   "compilerOptions": {
-    "paths": { "@/*": ["./*"] }
+    "paths": {
+      "@/*": ["./*"]
+    },
+    "allowJs": true,
+    "incremental": true,
+    "jsx": "preserve"
   },
   "include": ["**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
   "exclude": ["node_modules"]

package/.docs/organized/code-examples/with-tanstack.md

@@ -64,19 +64,19 @@
   "dependencies": {
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
-    "@tailwindcss/vite": "^4.2.1",
-    "@tanstack/react-router": "^1.166.8",
-    "@tanstack/react-start": "^1.166.9",
+    "@tailwindcss/vite": "^4.2.2",
+    "@tanstack/react-router": "^1.168.10",
+    "@tanstack/react-start": "^1.167.16",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.577.0",
+    "lucide-react": "^1.7.0",
     "nitro": "^3.0.1-alpha.2",
-    "openai": "^6.29.0",
+    "openai": "^6.33.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "vite-tsconfig-paths": "^6.1.1"
   },
   "devDependencies": {
@@ -85,8 +85,8 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.0"
+    "typescript": "5.9.3",
+    "vite": "^8.0.3"
   }
 }
 

package/.docs/organized/code-examples/with-tap-runtime.md

@@ -597,22 +597,22 @@ export default nextConfig;
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.577.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
+    "@tailwindcss/postcss": "^4.2.2",
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 
@@ -763,9 +763,9 @@ You can extend this example to:
 
 ## Learn More
 
-- [Tap Documentation](../../packages/tap/README.md)
-- [Store Documentation](../../packages/store/README.md)
-- [Client Implementation](../../packages/react/src/client/README.md)
+- [Tap Documentation](https://github.com/assistant-ui/assistant-ui/tree/main/packages/tap)
+- [Store Documentation](https://github.com/assistant-ui/assistant-ui/tree/main/packages/store)
+- [Client Implementation](https://github.com/assistant-ui/assistant-ui/tree/main/packages/react/src/client)
 - [Assistant UI Docs](https://assistant-ui.com)
 
 ```

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

@@ -53,6 +53,7 @@ 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.
 
@@ -214,6 +215,36 @@ npm install @assistant-ui/cloud-ai-sdk @ai-sdk/react ai
 
 ---
 
+## 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.

package/.docs/raw/docs/(docs)/cli.mdx

@@ -340,6 +340,56 @@ Options:
   -h, --help        display help for command
 ```
 
+## info
+
+Use the `info` command to print your environment and package versions for bug reports.
+
+```bash
+npx assistant-ui@latest info
+```
+
+This command collects and prints:
+- OS, Node.js version, package manager, and framework
+- All installed `@assistant-ui/*` and `assistant-*` package versions
+- Key ecosystem dependency versions (React, Next.js, AI SDK, etc.)
+- Peer dependency warnings if any mismatches are detected
+
+**Example output:**
+
+```
+Environment:
+  OS:               macOS 15.3 (arm64)
+  Node.js:          v22.14.0
+  Package Manager:  pnpm 10.32.1
+  Framework:        Next.js 15.3.1
+
+Packages:
+  @assistant-ui/react            0.12.15
+  @assistant-ui/react-ai-sdk     1.3.12
+  @assistant-ui/react-markdown   0.3.8
+  assistant-stream                0.2.14
+
+Ecosystem:
+  react      19.1.0
+  react-dom  19.1.0
+  next       15.3.1
+  ai         6.0.120
+```
+
+The output includes a copy-pasteable markdown block that you can paste directly into a [bug report](https://github.com/assistant-ui/assistant-ui/issues/new?template=bug_report.yml).
+
+**Options**
+
+```bash
+Usage: assistant-ui info [options]
+
+Print environment and package information for bug reports.
+
+Options:
+  -c, --cwd <cwd>  the working directory. defaults to the current directory.
+  -h, --help       display help for command
+```
+
 ## Common Workflows
 
 ### Starting a new project
@@ -426,6 +476,16 @@ sudo npx assistant-ui@latest init
 
 Or fix npm permissions: https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally
 
+### Diagnosing issues
+
+When filing a bug report, run `npx assistant-ui info` to collect environment details:
+
+```bash
+npx assistant-ui info
+```
+
+Paste the output into the "Environment info" field of the [bug report template](https://github.com/assistant-ui/assistant-ui/issues/new?template=bug_report.yml).
+
 ### Conflicting dependencies
 
 If you see dependency conflicts:

package/.docs/raw/docs/(docs)/copilots/model-context.mdx

@@ -14,17 +14,25 @@ System instructions define the base behavior and knowledge available to the assi
 ```tsx
 import {
   useAssistantInstructions,
+  useAssistantContext,
   makeAssistantVisible,
 } from "@assistant-ui/react";
 
-// Via useAssistantInstructions
+// Static instructions
 useAssistantInstructions("You are a helpful assistant...");
 
+// Dynamic context — callback is evaluated lazily at send-time
+useAssistantContext({
+  getContext: () => `Current page: ${window.location.href}`,
+});
+
 // Via makeAssistantVisible
 const ReadableComponent = makeAssistantVisible(MyComponent);
 // Automatically provides component HTML as system context
 ```
 
+`useAssistantInstructions` takes a static string that re-registers when changed. `useAssistantContext` takes a callback that is evaluated fresh each time the model context is read, making it ideal for injecting frequently-changing application state without triggering re-registrations.
+
 ### Tools
 
 Tools are functions that the assistant can use to interact with your application. They can be provided through various mechanisms:

package/.docs/raw/docs/(docs)/guides/attachments.mdx

@@ -94,14 +94,31 @@ const UserMessage = () => {
 
 ## Built-in Attachment Adapters
 
+### AI SDK Runtime (Default)
+
+When using `useChatRuntime`, the built-in adapter accepts all file types and converts them to base64 data URLs. This works well for images and small files.
+
+<Callout type="warn">
+  Most models only support **image** attachments. Sending unsupported file types (audio, video, PDF, etc.) will result in an API error. Check your model provider's documentation for supported input types.
+</Callout>
+
+To restrict accepted file types, pass a custom adapter:
+
+```tsx
+const runtime = useChatRuntime({
+  adapters: {
+    attachments: new SimpleImageAttachmentAdapter(), // only images
+  },
+});
+```
+
 ### SimpleImageAttachmentAdapter
 
-Handles image files and converts them to data URLs for display in the chat UI. By default, images are shown inline but not sent to the LLM - use the VisionImageAdapter example above to send images to vision-capable models.
+Handles image files and converts them to data URLs for display in the chat UI.
 
 ```tsx
 const imageAdapter = new SimpleImageAttachmentAdapter();
 // Accepts: image/* (JPEG, PNG, GIF, etc.)
-// Output: { type: "image", url: "data:image/..." }
 ```
 
 ### SimpleTextAttachmentAdapter
@@ -111,7 +128,6 @@ Processes text files and wraps content in formatted tags:
 ```tsx
 const textAdapter = new SimpleTextAttachmentAdapter();
 // Accepts: text/plain, text/html, text/markdown, etc.
-// Output: Content wrapped in <attachment>...</attachment> tags
 ```
 
 ### CompositeAttachmentAdapter
@@ -122,7 +138,6 @@ Combines multiple adapters to support various file types:
 const compositeAdapter = new CompositeAttachmentAdapter([
   new SimpleImageAttachmentAdapter(),
   new SimpleTextAttachmentAdapter(),
-  // Add more adapters as needed
 ]);
 ```
 
@@ -538,6 +553,52 @@ Attachments work with all assistant-ui runtimes:
   processing logic to fit your specific needs.
 </Callout>
 
+## Large File Uploads
+
+The built-in adapters convert files to base64 data URLs in memory. For large files (long audio, video, etc.), this can cause performance issues. Instead, upload to a server and pass the URL:
+
+```tsx
+class ServerUploadAdapter implements AttachmentAdapter {
+  accept = "*";
+  private urls = new Map<string, string>();
+
+  async *add({ file }: { file: File }) {
+    const id = crypto.randomUUID();
+    yield {
+      id, type: "file" as const, name: file.name, file,
+      contentType: file.type,
+      status: { type: "running" as const, reason: "uploading" as const, progress: 0 },
+    };
+
+    const form = new FormData();
+    form.append("file", file);
+    const { url } = await fetch("/api/upload", { method: "POST", body: form }).then(r => r.json());
+    this.urls.set(id, url);
+
+    yield {
+      id, type: "file" as const, name: file.name, file,
+      contentType: file.type,
+      status: { type: "requires-action" as const, reason: "composer-send" as const },
+    };
+  }
+
+  async send(attachment: PendingAttachment): Promise<CompleteAttachment> {
+    const url = this.urls.get(attachment.id)!;
+    this.urls.delete(attachment.id);
+    return {
+      ...attachment, status: { type: "complete" },
+      content: [{ type: "file", data: url, mimeType: attachment.contentType ?? "", filename: attachment.name }],
+    };
+  }
+
+  async remove() {}
+}
+```
+
+<Callout type="tip">
+  [assistant-ui Cloud](/docs/cloud/ai-sdk-assistant-ui) includes `CloudFileAttachmentAdapter` which handles large file uploads via presigned URLs out of the box.
+</Callout>
+
 ## Best Practices
 
 1. **File Size Limits**: Always validate file sizes to prevent memory issues