@assistant-ui/mcp-docs-server 0.1.17 → 0.1.19

package/.docs/raw/docs/ui/{SyntaxHighlighting.mdx → syntax-highlighting.mdx}

@@ -1,13 +1,12 @@
 ---
 title: Syntax Highlighting
+description: Code block syntax highlighting with react-shiki or react-syntax-highlighter.
 ---
 
-import { Steps, Step } from "fumadocs-ui/components/steps";
-import { Callout } from "fumadocs-ui/components/callout";
-import { TypeTable } from "fumadocs-ui/components/type-table";
-import { InstallCommand } from "@/components/docs/install-command";
+import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
+import { SyntaxHighlightingSample } from "@/components/docs/samples/syntax-highlighting";
 
-Syntax highlighting for code blocks in markdown.
+<SyntaxHighlightingSample />
 
 <Callout type="warn">Syntax highlighting is not enabled in markdown by default.</Callout>
 
@@ -248,3 +247,8 @@ By default, the syntax highlighter uses a light build that only includes languag
 ```tsx title="/components/assistant-ui/syntax-highlighter.tsx"
 import { makePrismAsyncSyntaxHighlighter } from "@assistant-ui/react-syntax-highlighter/full";
 ```
+
+## Related Components
+
+- [Markdown](/docs/ui/markdown) - Rich text rendering that uses syntax highlighting
+- [Mermaid](/docs/ui/mermaid) - Render diagrams instead of code blocks

package/.docs/raw/docs/ui/thread-list.mdx

@@ -0,0 +1,275 @@
+---
+title: ThreadList
+description: Switch between conversations. Supports sidebar or dropdown layouts.
+---
+
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
+import { ThreadListSample } from "@/components/docs/samples/threadlist";
+
+<ThreadListSample />
+
+<Callout>
+This demo uses **ThreadListSidebar**, which includes `thread-list` as a dependency and provides a complete sidebar layout. For custom implementations, you can use `thread-list` directly.
+</Callout>
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add the component
+
+Use `threadlist-sidebar` for a complete sidebar layout or `thread-list` for custom layouts.
+
+#### ThreadListSidebar
+
+<InstallCommand shadcn={["threadlist-sidebar"]} />
+
+#### ThreadList
+
+<InstallCommand shadcn={["thread-list"]} />
+
+  </Step>
+  <Step>
+
+### Use in your application
+
+<Tabs items={["With Sidebar", "Without Sidebar"]}>
+  <Tab value="With Sidebar">
+    ```tsx title="/app/assistant.tsx"
+    import { Thread } from "@/components/assistant-ui/thread";
+    import { ThreadListSidebar } from "@/components/assistant-ui/threadlist-sidebar";
+    import { 
+      SidebarProvider, 
+      SidebarInset,
+      SidebarTrigger 
+    } from "@/components/ui/sidebar";
+
+    export default function Assistant() {
+      return (
+        <SidebarProvider>
+          <div className="flex h-dvh w-full">
+            <ThreadListSidebar />
+            <SidebarInset>
+              {/* Add sidebar trigger, location can be customized */}
+              <SidebarTrigger className="absolute top-4 left-4" />
+              <Thread />
+            </SidebarInset>
+          </div>
+        </SidebarProvider>
+      );
+    }
+    ```
+  </Tab>
+  <Tab value="Without Sidebar">
+    ```tsx title="/app/assistant.tsx"
+    import { Thread } from "@/components/assistant-ui/thread";
+    import { ThreadList } from "@/components/assistant-ui/thread-list";
+
+    export default function Assistant() {
+      return (
+        <div className="grid h-full grid-cols-[200px_1fr]">
+          <ThreadList />
+          <Thread />
+        </div>
+      );
+    }
+    ```
+  </Tab>
+</Tabs>
+
+  </Step>
+</Steps>
+
+## Anatomy
+
+The ThreadList component is built with the following primitives:
+
+```tsx
+import { ThreadListPrimitive, ThreadListItemPrimitive } from "@assistant-ui/react";
+
+<ThreadListPrimitive.Root>
+  <ThreadListPrimitive.New />
+  <ThreadListPrimitive.Items
+    components={{
+      ThreadListItem: () => (
+        <ThreadListItemPrimitive.Root>
+          <ThreadListItemPrimitive.Trigger>
+            <ThreadListItemPrimitive.Title />
+          </ThreadListItemPrimitive.Trigger>
+          <ThreadListItemPrimitive.Archive />
+          <ThreadListItemPrimitive.Delete />
+        </ThreadListItemPrimitive.Root>
+      ),
+    }}
+  />
+</ThreadListPrimitive.Root>
+```
+
+## API Reference
+
+### ThreadListPrimitive.Root
+
+Container for the thread list.
+
+<ParametersTable
+  type="ThreadListPrimitiveRootProps"
+  parameters={[
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper div.",
+    },
+  ]}
+/>
+
+### ThreadListPrimitive.Items
+
+Renders all threads in the list.
+
+<ParametersTable
+  type="ThreadListPrimitiveItemsProps"
+  parameters={[
+    {
+      name: "archived",
+      type: "boolean",
+      description: "When true, renders archived threads instead of active threads.",
+    },
+    {
+      name: "components",
+      type: "object",
+      required: true,
+      description: "Component configuration.",
+      children: [
+        {
+          type: "Components",
+          parameters: [
+            {
+              name: "ThreadListItem",
+              type: "ComponentType",
+              required: true,
+              description: "Component to render for each thread item.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
+### ThreadListPrimitive.New
+
+A button to create a new thread.
+
+<ParametersTable
+  type="ThreadListPrimitiveNewProps"
+  parameters={[
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper button.",
+    },
+  ]}
+/>
+
+### ThreadListItemPrimitive.Root
+
+Container for a single thread item. Automatically sets `data-active` and `aria-current` when this is the current thread.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveRootProps"
+  parameters={[
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper div.",
+    },
+  ]}
+/>
+
+### ThreadListItemPrimitive.Trigger
+
+A button that switches to this thread when clicked.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveTriggerProps"
+  parameters={[
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper button.",
+    },
+  ]}
+/>
+
+### ThreadListItemPrimitive.Title
+
+Renders the thread's title.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveTitleProps"
+  parameters={[
+    {
+      name: "fallback",
+      type: "ReactNode",
+      description: "Content to display when the thread has no title.",
+    },
+  ]}
+/>
+
+### ThreadListItemPrimitive.Archive
+
+A button to archive the thread.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveArchiveProps"
+  parameters={[
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper button.",
+    },
+  ]}
+/>
+
+### ThreadListItemPrimitive.Unarchive
+
+A button to restore an archived thread.
+
+### ThreadListItemPrimitive.Delete
+
+A button to permanently delete the thread.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveDeleteProps"
+  parameters={[
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper button.",
+    },
+  ]}
+/>
+
+### ThreadListItemMore
+
+A dropdown menu for additional thread actions, built on Radix UI DropdownMenu:
+
+- `ThreadListItemMorePrimitive.Root` - Menu container
+- `ThreadListItemMorePrimitive.Trigger` - Button to open the menu
+- `ThreadListItemMorePrimitive.Content` - Menu content container
+- `ThreadListItemMorePrimitive.Item` - Individual menu item
+- `ThreadListItemMorePrimitive.Separator` - Visual separator between items
+
+## Related Components
+
+- [Thread](/docs/ui/thread) - The main chat interface displayed alongside the list
+
+

package/.docs/raw/docs/ui/{Thread.mdx → thread.mdx}

@@ -1,12 +1,11 @@
 ---
 title: Thread
+description: The main chat container with messages, composer, and auto-scroll.
 ---
 
-import { Steps, Step } from "fumadocs-ui/components/steps";
-import { Callout } from "fumadocs-ui/components/callout";
-import { ParametersTable } from "@/components/docs";
-import { InstallCommand } from "@/components/docs/install-command";
-import { ThreadSample } from "@/components/samples/thread-sample";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
+import { ThreadSample } from "@/components/docs/samples/thread";
 
 A complete chat interface that combines message rendering, auto-scrolling, composer input,
 attachments, and conditional UI states. Fully customizable and composable.
@@ -398,4 +397,4 @@ The condition function receives an `AssistantState` object with access to `threa
 
 ## Related Components
 
-- [ThreadList](/docs/ui/ThreadList) - List of threads, with or without sidebar
+- [ThreadList](/docs/ui/thread-list) - List of threads, with or without sidebar

package/.docs/raw/docs/ui/tool-fallback.mdx

@@ -0,0 +1,112 @@
+---
+title: ToolFallback
+description: Default UI component for tools without dedicated custom renderers.
+---
+
+import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
+import {
+  ToolFallbackSample,
+  ToolFallbackRunningSample,
+  ToolFallbackCancelledSample,
+  ToolFallbackStreamingSample,
+} from "@/components/docs/samples/tool-fallback";
+
+<ToolFallbackSample />
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add `tool-fallback`
+
+<InstallCommand shadcn={["tool-fallback"]} />
+
+This adds a `/components/assistant-ui/tool-fallback.tsx` file to your project, which you can adjust as needed.
+
+  </Step>
+  <Step>
+
+### Use it in your application
+
+Pass the `ToolFallback` component to the `MessagePrimitive.Parts` component
+
+```tsx title="/components/assistant-ui/thread.tsx" {1,9}
+import { ToolFallback } from "@/components/assistant-ui/tool-fallback";
+
+const AssistantMessage = () => {
+  return (
+    <MessagePrimitive.Root>
+      <MessagePrimitive.Parts
+        components={{
+          tools: { 
+            Fallback: ToolFallback 
+          },
+        }}
+      />
+    </MessagePrimitive.Root>
+  );
+};
+```
+
+  </Step>
+</Steps>
+
+## Examples
+
+### Streaming Demo
+
+Interactive demo showing the full tool call lifecycle: running → complete.
+
+<ToolFallbackStreamingSample />
+
+### Running State
+
+Shows a loading spinner and shimmer animation while the tool is executing.
+
+<ToolFallbackRunningSample />
+
+### Cancelled State
+
+Shows a muted appearance when a tool call was cancelled.
+
+<ToolFallbackCancelledSample />
+
+## Composable API
+
+All sub-components are exported for custom layouts:
+
+| Component | Description |
+| --------- | ----------- |
+| `ToolFallback.Root` | Collapsible container with scroll lock |
+| `ToolFallback.Trigger` | Header with tool name, status icon, and shimmer |
+| `ToolFallback.Content` | Animated collapsible content wrapper |
+| `ToolFallback.Args` | Displays tool arguments |
+| `ToolFallback.Result` | Displays tool execution result |
+| `ToolFallback.Error` | Displays error or cancellation messages |
+
+```tsx
+import {
+  ToolFallback,
+  ToolFallbackRoot,
+  ToolFallbackTrigger,
+  ToolFallbackContent,
+  ToolFallbackArgs,
+  ToolFallbackResult,
+  ToolFallbackError,
+} from "@/components/assistant-ui/tool-fallback";
+
+// Compound component syntax
+<ToolFallback.Root>
+  <ToolFallback.Trigger toolName="get_weather" status={status} />
+  <ToolFallback.Content>
+    <ToolFallback.Error status={status} />
+    <ToolFallback.Args argsText={argsText} />
+    <ToolFallback.Result result={result} />
+  </ToolFallback.Content>
+</ToolFallback.Root>
+```
+
+## Related Components
+
+- [ToolGroup](/docs/ui/tool-group) - Group consecutive tool calls together

package/.docs/raw/docs/ui/tool-group.mdx

@@ -0,0 +1,214 @@
+---
+title: ToolGroup
+description: Wrapper for consecutive tool calls with collapsible and styled options.
+---
+
+import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import {
+  ToolGroupSample,
+  ToolGroupStreamingSample,
+} from "@/components/docs/samples/tool-group";
+
+A wrapper component that groups consecutive tool calls together, displaying them in a collapsible container with auto-expand behavior during streaming.
+
+<ToolGroupSample />
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add `tool-group`
+
+<InstallCommand shadcn={["tool-group"]} />
+
+This adds a `/components/assistant-ui/tool-group.tsx` file to your project, which you can adjust as needed.
+
+  </Step>
+  <Step>
+
+### Use it in your application
+
+Pass the `ToolGroup` component to the `MessagePrimitive.Parts` component
+
+```tsx title="/components/assistant-ui/thread.tsx" {1,8}
+import { ToolGroup } from "@/components/assistant-ui/tool-group";
+
+const AssistantMessage = () => {
+  return (
+    <MessagePrimitive.Root>
+      <MessagePrimitive.Parts
+        components={{
+          ToolGroup,
+        }}
+      />
+    </MessagePrimitive.Root>
+  );
+};
+```
+
+  </Step>
+</Steps>
+
+## Variants
+
+Use the `variant` prop on `ToolGroup.Root` to change the visual style:
+
+```tsx
+<ToolGroup.Root variant="outline">...</ToolGroup.Root>
+<ToolGroup.Root variant="muted">...</ToolGroup.Root>
+```
+
+| Variant   | Description                        |
+| --------- | ---------------------------------- |
+| `default` | No additional styling              |
+| `outline` | Rounded border                     |
+| `muted`   | Muted background with border       |
+
+## Examples
+
+### Streaming Demo (Custom UI + Fallback)
+
+Interactive demo showing tool group with **custom tool UIs** and **ToolFallback** working together. Watch as weather cards stream in with loading states, followed by a search tool using the fallback UI.
+
+<ToolGroupStreamingSample />
+
+### Custom Tool UIs
+
+ToolGroup works with any custom tool UI components:
+
+```tsx
+// Custom Weather Tool UI
+function WeatherToolUI({ location, temperature, condition }) {
+  return (
+    <div className="flex items-center gap-3 rounded-lg border p-3">
+      <WeatherIcon condition={condition} />
+      <div>
+        <div className="text-xs text-muted-foreground">{location}</div>
+        <div className="text-lg font-medium">{temperature}°F</div>
+      </div>
+    </div>
+  );
+}
+
+// Use in ToolGroup
+<ToolGroupRoot variant="outline">
+  <ToolGroupTrigger count={3} />
+  <ToolGroupContent>
+    <WeatherToolUI location="New York" temperature={65} condition="Cloudy" />
+    <WeatherToolUI location="London" temperature={55} condition="Rainy" />
+    <SearchToolUI query="best restaurants" results={24} />
+  </ToolGroupContent>
+</ToolGroupRoot>
+```
+
+## Composable API
+
+All sub-components are exported for custom layouts:
+
+| Component | Description |
+| --------- | ----------- |
+| `ToolGroup.Root` | Collapsible container with scroll lock and variants |
+| `ToolGroup.Trigger` | Header with tool count, shimmer animation, and chevron |
+| `ToolGroup.Content` | Animated collapsible content wrapper |
+
+```tsx
+import {
+  ToolGroup,
+  ToolGroupRoot,
+  ToolGroupTrigger,
+  ToolGroupContent,
+} from "@/components/assistant-ui/tool-group";
+
+// Compound component syntax
+<ToolGroup.Root variant="outline" defaultOpen>
+  <ToolGroup.Trigger count={3} active={false} />
+  <ToolGroup.Content>
+    {/* Any tool UI components - custom or ToolFallback */}
+  </ToolGroup.Content>
+</ToolGroup.Root>
+```
+
+## API Reference
+
+### ToolGroupRoot
+
+<ParametersTable
+  type="ToolGroupRootProps"
+  parameters={[
+    {
+      name: "variant",
+      type: '"default" | "outline" | "muted"',
+      default: '"default"',
+      description: "Visual variant of the tool group container.",
+    },
+    {
+      name: "open",
+      type: "boolean",
+      description: "Controlled open state.",
+    },
+    {
+      name: "onOpenChange",
+      type: "(open: boolean) => void",
+      description: "Callback when open state changes.",
+    },
+    {
+      name: "defaultOpen",
+      type: "boolean",
+      default: "false",
+      description: "Initial open state for uncontrolled usage.",
+    },
+  ]}
+/>
+
+### ToolGroupTrigger
+
+<ParametersTable
+  type="ToolGroupTriggerProps"
+  parameters={[
+    {
+      name: "count",
+      type: "number",
+      required: true,
+      description: "Number of tool calls to display in the label.",
+    },
+    {
+      name: "active",
+      type: "boolean",
+      default: "false",
+      description: "Shows loading spinner and shimmer animation when true.",
+    },
+  ]}
+/>
+
+### ToolGroup (Default Export)
+
+<ParametersTable
+  type="ToolGroupProps"
+  parameters={[
+    {
+      name: "startIndex",
+      type: "number",
+      required: true,
+      description: "The index of the first tool call in the group.",
+    },
+    {
+      name: "endIndex",
+      type: "number",
+      required: true,
+      description: "The index of the last tool call in the group.",
+    },
+    {
+      name: "children",
+      type: "ReactNode",
+      required: true,
+      description: "The rendered tool call components.",
+    },
+  ]}
+/>
+
+## Related Components
+
+- [ToolFallback](/docs/ui/tool-fallback) - Default UI for tools without custom renderers
+- [PartGrouping](/docs/ui/part-grouping) - Advanced message part grouping (experimental)

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const ROOT_DIR: string;
+export declare const PACKAGE_DIR: string;
+export declare const EXAMPLES_PATH: string;
+export declare const DOCS_PATH: string;
+export declare const CODE_EXAMPLES_PATH: string;
+export declare const MDX_EXTENSION = ".mdx";
+export declare const MD_EXTENSION = ".md";
+export declare const MAX_FILE_SIZE: number;
+export declare const IS_PREPARE_MODE: boolean | undefined;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,QAA+B,CAAC;AACrD,eAAO,MAAM,WAAW,QAAyB,CAAC;AAElD,eAAO,MAAM,aAAa,QAA6B,CAAC;AAGxD,eAAO,MAAM,SAAS,QAA8B,CAAC;AACrD,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAE7E,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,aAAa,QAAmB,CAAC;AAE9C,eAAO,MAAM,eAAe,qBAE3B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const ROOT_DIR = join(__dirname, "../../../");
+export const PACKAGE_DIR = join(__dirname, "../");
+export const EXAMPLES_PATH = join(ROOT_DIR, "examples");
+const DOCS_BASE = join(PACKAGE_DIR, ".docs");
+export const DOCS_PATH = join(DOCS_BASE, "raw/docs");
+export const CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
+export const MDX_EXTENSION = ".mdx";
+export const MD_EXTENSION = ".md";
+export const MAX_FILE_SIZE = 10 * 1024 * 1024;
+export const IS_PREPARE_MODE = process.argv[1]?.includes("prepare-docs/prepare");
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAExD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CACtD,sBAAsB,CACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,eAAO,MAAM,MAAM,WAGjB,CAAC;AAeH,wBAAsB,SAAS,kBAW9B"}