@assistant-ui/mcp-docs-server 0.2.3 → 0.3.0

package/.docs/raw/docs/primitives/error.mdx

@@ -1,142 +0,0 @@
----
-title: Error
-description: Accessible error display for messages with automatic error text extraction.
-platforms: ["react"]
----
-
-import { ErrorPrimitiveSample } from "@/components/pages/docs/samples/error-primitive";
-
-The Error primitive renders error states on messages using an accessible `role="alert"` container with automatic error text extraction. `Root` always renders its container; `Message` only renders when the message has an error. Wrap in `MessagePrimitive.Error` if you need the entire block to be conditional.
-
-<Tabs items={["Preview", "Code"]}>
-  <Tab>
-    <ErrorPrimitiveSample />
-  </Tab>
-  <Tab>
-```tsx
-import { ErrorPrimitive, MessagePrimitive } from "@assistant-ui/react";
-
-function AssistantMessage() {
-  return (
-    <MessagePrimitive.Root>
-      <MessagePrimitive.Parts />
-      <ErrorPrimitive.Root className="rounded-md bg-destructive/10 px-3 py-2 text-sm text-destructive">
-        <ErrorPrimitive.Message />
-      </ErrorPrimitive.Root>
-    </MessagePrimitive.Root>
-  );
-}
-```
-  </Tab>
-</Tabs>
-
-## Quick Start
-
-A minimal error display below a message:
-
-```tsx
-import { ErrorPrimitive, MessagePrimitive } from "@assistant-ui/react";
-
-<MessagePrimitive.Root>
-  <MessagePrimitive.Parts />
-  <ErrorPrimitive.Root>
-    <ErrorPrimitive.Message />
-  </ErrorPrimitive.Root>
-</MessagePrimitive.Root>
-```
-
-`Root` renders a `<div>` with `role="alert"` for screen reader accessibility. `Message` renders a `<span>` that auto-reads the error text from message state, and it returns `null` when there is no error. `Root` itself always renders. Wrap in `<MessagePrimitive.Error>` if you want the entire block (including `Root`) to be conditional.
-
-<Callout type="info">
-ErrorPrimitive must be placed inside a `MessagePrimitive.Root` because it reads the error state from the nearest message context.
-</Callout>
-
-<Callout type="info">
-Runtime setup: primitives require runtime context. Wrap your UI in `AssistantRuntimeProvider` with a runtime (for example `useLocalRuntime(...)`). See [Pick a Runtime](/docs/runtimes/pick-a-runtime).
-</Callout>
-
-## Core Concepts
-
-### Auto-Rendering on Error
-
-`Message` checks the message status and only renders when `status.type === "incomplete"` and `status.reason === "error"`. `Root` always renders its `<div role="alert">` container. For fully conditional rendering, wrap in `<MessagePrimitive.Error>`.
-
-### Automatic Error Text
-
-`ErrorPrimitive.Message` reads the error object from message state and converts it to a string. If you pass `children`, they override the automatic text:
-
-```tsx
-// Auto-reads error text from state
-<ErrorPrimitive.Message />
-
-// Custom children override the default
-<ErrorPrimitive.Message>
-  Something went wrong. Please try again.
-</ErrorPrimitive.Message>
-```
-
-### ErrorPrimitive vs MessagePrimitive.Error
-
-`MessagePrimitive.Error` is a simpler alternative. It renders its children when the message has an error but does not provide `role="alert"` or auto-extract the error text. Use `ErrorPrimitive` when you want accessible error rendering with automatic text.
-
-```tsx
-// ErrorPrimitive: accessible, auto-reads error text
-<ErrorPrimitive.Root role="alert">
-  <ErrorPrimitive.Message />
-</ErrorPrimitive.Root>
-
-// MessagePrimitive.Error: simpler, manual text
-<MessagePrimitive.Error>
-  <div>Something went wrong.</div>
-</MessagePrimitive.Error>
-```
-
-## Parts
-
-### Root
-
-Container for an error message block. Renders a `<div>` element unless `asChild` is set.
-
-```tsx
-<ErrorPrimitive.Root className="rounded-md border border-destructive/20 bg-destructive/5 p-3">
-  <ErrorPrimitive.Message />
-</ErrorPrimitive.Root>
-```
-
-### Message
-
-Renders the current error text for the active message.
-
-```tsx
-<ErrorPrimitive.Message className="text-destructive text-sm" />
-```
-
-## Patterns
-
-### Styled Error Alert
-
-```tsx
-<ErrorPrimitive.Root className="mt-2 flex items-center gap-2 rounded-md bg-destructive/10 px-3 py-2 text-sm text-destructive">
-  <ErrorPrimitive.Message />
-</ErrorPrimitive.Root>
-```
-
-### Custom Error Content
-
-```tsx
-<ErrorPrimitive.Root className="mt-2 rounded-md border border-destructive/20 bg-destructive/5 p-3">
-  <p className="font-medium text-destructive text-sm">Error</p>
-  <ErrorPrimitive.Message className="text-destructive/80 text-sm" />
-</ErrorPrimitive.Root>
-```
-
-## Relationship to Components
-
-The shadcn [Thread](/docs/ui/thread) component uses `ErrorPrimitive` inside its `AssistantMessage` to display errors below the message content. If you need a pre-built error display, start there.
-
-## API Reference
-
-For full prop details on every part, see the [ErrorPrimitive API Reference](/docs/api-reference/primitives/error).
-
-Related:
-- [MessagePrimitive API Reference](/docs/api-reference/primitives/message)

package/.docs/raw/docs/primitives/index.mdx

@@ -1,99 +0,0 @@
----
-title: Headless Chat Primitives
-description: Unstyled, accessible Radix-style building blocks for React AI chat interfaces — Thread, Composer, Message, and more, ready to compose with assistant-ui.
-platforms: ["react"]
----
-
-Primitives are the foundation of assistant-ui. They are unstyled, accessible React components that handle all the wiring for AI chat, including state management, keyboard shortcuts, auto-scrolling, streaming, and tool calls, so you can focus entirely on your UI.
-
-## Why Primitives?
-
-Every assistant-ui [Component](/docs/ui/thread) is built from primitives. When you install a component like `Thread`, you get a pre-styled composition of primitives with default styling and behavior included.
-
-But when you need a UI that doesn't fit the defaults, such as a floating composer, a custom message layout, or an inline editing experience, you reach for the primitives directly.
-
-```tsx
-import { ComposerPrimitive } from "@assistant-ui/react";
-
-<ComposerPrimitive.Root>
-  <ComposerPrimitive.Input placeholder="Ask anything..." />
-  <ComposerPrimitive.Send>Send</ComposerPrimitive.Send>
-</ComposerPrimitive.Root>
-```
-
-This renders an unstyled `<form>` with a `<textarea>` and a `<button>`. No styles, no opinions, but it already handles submit-on-enter, focus management, empty-state disabling, and streaming state.
-
-## How They Work
-
-Every primitive follows the same pattern inspired by [Radix UI](https://www.radix-ui.com/):
-
-- **`Primitive.Root`**: container that provides context to child parts
-- **`Primitive.PartName`**: individual elements (input, button, text, etc.)
-- **`asChild`**: merge primitive behavior onto your own element instead of rendering a wrapper
-- **`AuiIf`**: conditional rendering based on state
-
-Primitives read from the nearest runtime context. Place them inside an `AssistantRuntimeProvider` and they work without prop drilling or manual state wiring.
-
-## Available Primitives
-
-<Cards>
-  <Card title="Composer" href="/docs/primitives/composer">
-    Text input, send button, attachments, and dictation. The interface for composing new messages or editing existing ones.
-  </Card>
-  <Card title="Thread" href="/docs/primitives/thread">
-    The scrollable message container with auto-scroll, empty states, and message rendering.
-  </Card>
-  <Card title="Message" href="/docs/primitives/message">
-    Individual message rendering with role-based content, parts, and metadata.
-  </Card>
-  <Card title="ActionBar" href="/docs/primitives/action-bar">
-    Copy, reload, edit, and other message actions.
-  </Card>
-  <Card title="BranchPicker" href="/docs/primitives/branch-picker">
-    Navigate between message branches (alternative responses).
-  </Card>
-  <Card title="ThreadList" href="/docs/primitives/thread-list">
-    Multi-thread management: list, create, switch, and archive threads.
-  </Card>
-  <Card title="AssistantModal" href="/docs/primitives/assistant-modal">
-    Floating chat popover built on Radix UI Popover.
-  </Card>
-  <Card title="Attachment" href="/docs/primitives/attachment">
-    File and image attachment rendering.
-  </Card>
-  <Card title="Suggestion" href="/docs/primitives/suggestion">
-    Suggested prompts and quick actions.
-  </Card>
-  <Card title="SelectionToolbar" href="/docs/primitives/selection-toolbar">
-    Floating toolbar for text selection actions like quoting.
-  </Card>
-  <Card title="Error" href="/docs/primitives/error">
-    Error display with accessible alert role and automatic error text.
-  </Card>
-  <Card title="ChainOfThought" href="/docs/primitives/chain-of-thought">
-    Collapsible reasoning accordion for thinking steps and tool calls.
-  </Card>
-</Cards>
-
-`MessagePartPrimitive` (for rendering individual text, image, and streaming parts) is documented within the [Message](/docs/primitives/message#messagepartprimitive) primitive page.
-
-## Related Primitive References
-
-Additional primitive references:
-
-- [MessagePartPrimitive](/docs/api-reference/primitives/message-part)
-- [ThreadListItemPrimitive](/docs/api-reference/primitives/thread-list-item)
-- [ThreadListItemMorePrimitive](/docs/api-reference/primitives/thread-list-item-more)
-- [ActionBarMorePrimitive](/docs/api-reference/primitives/action-bar-more)
-- [AuiIf](/docs/api-reference/primitives/assistant-if)
-
-## Common Mistakes
-
-- Forgetting to wrap primitives with runtime context (`AssistantRuntimeProvider` + runtime hook)
-- Mixing deprecated props with current APIs (`submitOnEnter`, `autoSend`, legacy `Suggestion`)
-- Mounting primitives in the wrong context (`ActionBarPrimitive` / `BranchPickerPrimitive` outside `MessagePrimitive.Root`)
-- Using unstable props unintentionally (`unstable_*` APIs)
-
-## Next Steps
-
-Start with the [Composer](/docs/primitives/composer) primitive to see how primitives work in practice, or jump to the [API Reference](/docs/api-reference/primitives/composer) for full prop details.