@assistant-ui/mcp-docs-server 0.1.31 → 0.1.33

package/.docs/raw/docs/(reference)/api-reference/primitives/message.mdx

@@ -1,13 +1,17 @@
 ---
 title: MessagePrimitive
-description: Components for rendering message content, parts, and attachments.
+description: Message primitives for rendering assistant and user turns, message parts, attachments, actions, editing, and branch controls.
 ---
 
+import { MessagePrimitiveAttachmentByIndexProps, MessagePrimitiveAttachmentsProps, MessagePrimitiveContentProps, MessagePrimitiveGenerativeUIProps, MessagePrimitiveGroupedPartsProps, MessagePrimitiveIfProps, MessagePrimitivePartByIndexProps, MessagePrimitivePartsProps, MessagePrimitiveQuoteProps, MessagePrimitiveRootProps, MessagePrimitiveUnstable_PartsGroupedByParentIdProps, MessagePrimitiveUnstable_PartsGroupedProps } from "@/generated/typeDocs";
 import { MessagePrimitive as MessagePrimitiveDocs } from "@/generated/primitiveDocs";
 
-A single message in a conversation. Messages may consist of multiple parts.
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
 
+For examples and usage patterns, see [Message](/docs/primitives/message).
 
+{/* api-manual:start */}
 ## Anatomy
 
 ```tsx
@@ -29,641 +33,251 @@ const AssistantMessage = () => (
   </MessagePrimitive.Root>
 );
 ```
+{/* api-manual:end */}
+
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
 
 ## API Reference
 
 ### Root
 
-Contains all parts of the message.
+{MessagePrimitiveDocs.Root?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Root.deprecated}
+  </Callout>
+)}
 
-This primitive renders a `<div>` element unless `asChild` is set.
+{MessagePrimitiveDocs.Root?.description}
 
-<ParametersTable
-  type="MessagePrimitiveRootProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{MessagePrimitiveDocs.Root?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Root?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-### Parts
+<ParametersTable {...MessagePrimitiveRootProps} />
 
-The content of the message. This renders a separate component for each message part.
-
-<ParametersTable
-  type="MessagePrimitivePartsProps"
-  parameters={[
-    {
-      name: "components",
-      required: false,
-      type: "MessagePartComponents",
-      description: "The components to render for each message part.",
-      children: [
-        {
-          type: "MessagePartComponents",
-          parameters: [
-            {
-              name: "Text",
-              type: "TextMessagePartComponent",
-              description:
-                "The component to render for each text message part.",
-            },
-            {
-              name: "Image",
-              type: "ImageMessagePartComponent",
-              description:
-                "The component to render for each image message part.",
-            },
-            {
-              name: "Source",
-              type: "SourceMessagePartComponent",
-              description:
-                "The component to render for each source message part.",
-            },
-            {
-              name: "File",
-              type: "FileMessagePartComponent",
-              description:
-                "The component to render for each file message part.",
-            },
-            {
-              name: "Unstable_Audio",
-              type: "Unstable_AudioMessagePartComponent",
-              description:
-                "The component to render for each audio message part.",
-            },
-            {
-              name: "Reasoning",
-              type: "ReasoningMessagePartComponent",
-              description:
-                "Deprecated components-map renderer for each reasoning message part. Prefer the children render function or MessagePrimitive.GroupedParts.",
-            },
-            {
-              name: "tools",
-              type: "object",
-              description:
-                "Deprecated components-map configuration for tool call rendering. Prefer part.toolUI in the children render function or MessagePrimitive.GroupedParts.",
-              children: [
-                {
-                  parameters: [
-                    {
-                      name: "by_name",
-                      type: "Record<string, ToolCallMessagePartComponent>",
-                      description:
-                        "Map of tool names to their specific components.",
-                    },
-                    {
-                      name: "Fallback",
-                      type: "ToolCallMessagePartComponent",
-                      description:
-                        "Fallback component for tool calls not matched by by_name.",
-                    },
-                    {
-                      name: "Override",
-                      type: "ComponentType<ToolCallMessagePartProps>",
-                      description:
-                        "Override component that handles all tool calls. When set, by_name and Fallback are ignored.",
-                    },
-                  ],
-                },
-              ],
-            },
-            {
-              name: "data",
-              type: "object",
-              description:
-                "Configuration for data part rendering.",
-              children: [
-                {
-                  parameters: [
-                    {
-                      name: "by_name",
-                      type: "Record<string, DataMessagePartComponent>",
-                      description:
-                        "Map of data event names to their specific components.",
-                    },
-                    {
-                      name: "Fallback",
-                      type: "DataMessagePartComponent",
-                      description:
-                        "Fallback component for data events not matched by by_name.",
-                    },
-                  ],
-                },
-              ],
-            },
-            {
-              name: "ToolGroup",
-              type: "ComponentType<PropsWithChildren<{ startIndex: number; endIndex: number }>>",
-              description:
-                "Deprecated legacy wrapper for grouped consecutive tool calls. Prefer MessagePrimitive.GroupedParts with groupBy returning \"group-tool\".",
-              children: [
-                {
-                  type: "ToolGroupProps",
-                  parameters: [
-                    {
-                      name: "startIndex",
-                      type: "number",
-                      description: "Index of the first tool call in the group.",
-                      required: true,
-                    },
-                    {
-                      name: "endIndex",
-                      type: "number",
-                      description: "Index of the last tool call in the group.",
-                      required: true,
-                    },
-                    {
-                      name: "children",
-                      type: "ReactNode",
-                      description:
-                        "The rendered tool call components within the group.",
-                      required: true,
-                    },
-                  ],
-                },
-              ],
-            },
-            {
-              name: "ReasoningGroup",
-              type: "ReasoningGroupComponent",
-              description:
-                "Deprecated legacy wrapper for grouped consecutive reasoning parts. Prefer MessagePrimitive.GroupedParts with groupBy returning \"group-reasoning\".",
-              children: [
-                {
-                  type: "ReasoningGroupProps",
-                  parameters: [
-                    {
-                      name: "startIndex",
-                      type: "number",
-                      description: "Index of the first reasoning part in the group.",
-                      required: true,
-                    },
-                    {
-                      name: "endIndex",
-                      type: "number",
-                      description: "Index of the last reasoning part in the group.",
-                      required: true,
-                    },
-                    {
-                      name: "children",
-                      type: "ReactNode",
-                      description:
-                        "The rendered reasoning part components within the group.",
-                      required: true,
-                    },
-                  ],
-                },
-              ],
-            },
-            {
-              name: "ChainOfThought",
-              type: "ComponentType",
-              description:
-                "Deprecated legacy grouping path. Prefer MessagePrimitive.GroupedParts for grouped reasoning and tool calls.",
-            },
-            {
-              name: "Empty",
-              type: "EmptyMessagePartComponent",
-              description:
-                "Component to render when the message has no parts, or when unstable_showEmptyOnNonTextEnd is enabled and the last part is not text or reasoning.",
-            },
-          ],
-        },
-      ],
-    },
-    {
-      name: "unstable_showEmptyOnNonTextEnd",
-      required: false,
-      type: "boolean",
-      description:
-        "When enabled, shows the Empty component if the last part in the message is anything other than Text or Reasoning. Defaults to true.",
-    },
-  ]}
-/>
+### Parts
 
-### Quote
+{MessagePrimitiveDocs.Parts?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Parts.deprecated}
+  </Callout>
+)}
 
-Renders a quote block if the message has quote metadata (`message.metadata.custom.quote`). Place this above `MessagePrimitive.Parts`.
+{MessagePrimitiveDocs.Parts?.description}
 
-```tsx
-<MessagePrimitive.Quote>
-  {({ text, messageId }) => <QuoteBlock text={text} messageId={messageId} />}
-</MessagePrimitive.Quote>
-```
+{MessagePrimitiveDocs.Parts?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Parts?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<ParametersTable
-  type="MessagePrimitiveQuoteProps"
-  parameters={[
-    {
-      name: "children",
-      required: true,
-      type: "(quote: QuoteInfo) => ReactNode",
-      description: "Render function called when a quote is present. Receives { text, messageId }.",
-    },
-  ]}
-/>
+<ParametersTable {...MessagePrimitivePartsProps} />
 
 ### PartByIndex
 
-Renders a single message part at the specified index.
+{MessagePrimitiveDocs.PartByIndex?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.PartByIndex.deprecated}
+  </Callout>
+)}
 
-```tsx
-<MessagePrimitive.PartByIndex
-  index={0}
-  components={{
-    Text: MyTextComponent,
-    Image: MyImageComponent
-  }}
-/>
-```
+{MessagePrimitiveDocs.PartByIndex?.description}
+
+{MessagePrimitiveDocs.PartByIndex?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.PartByIndex?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...MessagePrimitivePartByIndexProps} />
+
+### Content
+
+{MessagePrimitiveDocs.Content?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Content.deprecated}
+  </Callout>
+)}
+
+{MessagePrimitiveDocs.Content?.description}
+
+{MessagePrimitiveDocs.Content?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Content?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...MessagePrimitiveContentProps} />
 
-<ParametersTable
-  type="MessagePrimitive.PartByIndex.Props"
-  parameters={[
-    {
-      name: "index",
-      type: "number",
-      required: true,
-      description: "The index of the message part to render.",
-    },
-    {
-      name: "components",
-      required: false,
-      type: "MessagePartComponents",
-      description: "The components to render for the message part.",
-    },
-  ]}
-/>
+### If
+
+{MessagePrimitiveDocs.If?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.If.deprecated}
+  </Callout>
+)}
+
+{MessagePrimitiveDocs.If?.description}
+
+{MessagePrimitiveDocs.If?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.If?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...MessagePrimitiveIfProps} />
 
 ### Attachments
 
-Renders all attachments of the message.
-
-<ParametersTable
-  type="MessagePrimitive.Attachments.Props"
-  parameters={[
-    {
-      name: "components",
-      type: "AttachmentComponents",
-      description: "The components to render for each attachment.",
-      children: [
-        {
-          type: "AttachmentComponents",
-          parameters: [
-            {
-              name: "Image",
-              type: "ComponentType",
-              description: "The component to render for image attachments.",
-            },
-            {
-              name: "Document",
-              type: "ComponentType",
-              description: "The component to render for document attachments.",
-            },
-            {
-              name: "File",
-              type: "ComponentType",
-              description: "The component to render for file attachments.",
-            },
-            {
-              name: "Attachment",
-              type: "ComponentType",
-              description: "The fallback component to render for any attachment type.",
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
+{MessagePrimitiveDocs.Attachments?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Attachments.deprecated}
+  </Callout>
+)}
+
+{MessagePrimitiveDocs.Attachments?.description}
+
+{MessagePrimitiveDocs.Attachments?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Attachments?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...MessagePrimitiveAttachmentsProps} />
 
 ### AttachmentByIndex
 
-Renders a single attachment at the specified index within the message.
+{MessagePrimitiveDocs.AttachmentByIndex?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.AttachmentByIndex.deprecated}
+  </Callout>
+)}
 
-```tsx
-<MessagePrimitive.AttachmentByIndex
-  index={0}
-  components={{
-    Image: MyImageAttachment,
-    Document: MyDocumentAttachment
-  }}
-/>
-```
+{MessagePrimitiveDocs.AttachmentByIndex?.description}
 
-<ParametersTable
-  type="MessagePrimitive.AttachmentByIndex.Props"
-  parameters={[
-    {
-      name: "index",
-      type: "number",
-      required: true,
-      description: "The index of the attachment to render.",
-    },
-    {
-      name: "components",
-      type: "AttachmentComponents",
-      description: "The components to render for the attachment.",
-    },
-  ]}
-/>
-
-### useMessageQuote()
-
-A hook that returns the quote info attached to the current message, if any. Reads from `message.metadata.custom.quote`.
+{MessagePrimitiveDocs.AttachmentByIndex?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.AttachmentByIndex?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-```tsx
-import { useMessageQuote } from "@assistant-ui/react";
-
-const QuoteBlock = () => {
-  const quote = useMessageQuote();
-  if (!quote) return null;
-
-  return (
-    <div className="mb-2 flex items-start gap-1.5 text-sm italic text-muted-foreground">
-      {quote.text}
-    </div>
-  );
-};
-```
+<ParametersTable {...MessagePrimitiveAttachmentByIndexProps} />
 
-**Returns:** `QuoteInfo | undefined`
+### Quote
 
-```typescript
-type QuoteInfo = {
-  readonly text: string;       // the quoted plain text
-  readonly messageId: string;  // the source message ID
-};
-```
+{MessagePrimitiveDocs.Quote?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Quote.deprecated}
+  </Callout>
+)}
+
+{MessagePrimitiveDocs.Quote?.description}
+
+{MessagePrimitiveDocs.Quote?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Quote?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<Callout type="info">
-See the [Quoting guide](/docs/guides/quoting) for a complete walkthrough.
-</Callout>
+<ParametersTable {...MessagePrimitiveQuoteProps} />
+
+### Error
+
+{MessagePrimitiveDocs.Error?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Error.deprecated}
+  </Callout>
+)}
+
+{MessagePrimitiveDocs.Error?.description}
+
+{MessagePrimitiveDocs.Error?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Error?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+{MessagePrimitiveDocs.Error?.props && (
+  <ParametersTable type={MessagePrimitiveDocs.Error?.element} parameters={MessagePrimitiveDocs.Error.props} />
+)}
 
 ### GroupedParts
 
-Renders adjacent message parts through a hierarchical grouping tree. Use this for grouped Chain of Thought, consecutive tool calls, or any other adjacent grouping where each part stays in chronological order.
+{MessagePrimitiveDocs.GroupedParts?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.GroupedParts.deprecated}
+  </Callout>
+)}
 
-```tsx
-<MessagePrimitive.GroupedParts
-  groupBy={(part) => {
-    if (part.type === "reasoning")
-      return ["group-chainOfThought", "group-reasoning"];
-    if (part.type === "tool-call")
-      return ["group-chainOfThought", "group-tool"];
-    return null;
-  }}
->
-  {({ part, children }) => {
-    switch (part.type) {
-      case "group-chainOfThought":
-        return <div>{children}</div>;
-      case "group-reasoning":
-        return <ReasoningRoot>{children}</ReasoningRoot>;
-      case "group-tool":
-        return <ToolGroupRoot>{children}</ToolGroupRoot>;
-      case "text":
-        return <MarkdownText />;
-      case "reasoning":
-        return <Reasoning {...part} />;
-      case "tool-call":
-        return part.toolUI ?? <ToolFallback {...part} />;
-      case "data":
-        return part.dataRendererUI;
-      default:
-        return null;
-    }
-  }}
-</MessagePrimitive.GroupedParts>
-```
+{MessagePrimitiveDocs.GroupedParts?.description}
 
-<ParametersTable
-  type="MessagePrimitiveGroupedPartsProps"
-  parameters={MessagePrimitiveDocs.GroupedParts.props}
-/>
+{MessagePrimitiveDocs.GroupedParts?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.GroupedParts?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-### Unstable_PartsGrouped
+<ParametersTable {...MessagePrimitiveGroupedPartsProps} />
 
-Renders the parts of a message grouped by a custom grouping function. Use this unstable API only when you need non-adjacent clustering, such as collecting parts that share a common parent ID across different positions. For adjacent grouping, prefer `MessagePrimitive.GroupedParts`.
+### GenerativeUI
 
-The `groupingFunction` prop controls how parts are grouped. It receives the full array of message parts and must return an array of group descriptors, each with a `groupKey` (or `undefined` for ungrouped parts) and an array of `indices` into the message parts array. The optional `components.Group` component is then rendered once per group and receives the `groupKey`, `indices`, and the rendered part children.
+{MessagePrimitiveDocs.GenerativeUI?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.GenerativeUI.deprecated}
+  </Callout>
+)}
 
-<Callout type="warn">
-This API is unstable and may change in a future release.
-</Callout>
+{MessagePrimitiveDocs.GenerativeUI?.description}
 
-```tsx
-<MessagePrimitive.Unstable_PartsGrouped
-  groupingFunction={(parts) => {
-    const groups = new Map<string, number[]>();
-    parts.forEach((part, i) => {
-      const key = part.parentId ?? `__ungrouped_${i}`;
-      const indices = groups.get(key) ?? [];
-      indices.push(i);
-      groups.set(key, indices);
-    });
-    return Array.from(groups.entries()).map(([key, indices]) => ({
-      groupKey: key.startsWith("__ungrouped_") ? undefined : key,
-      indices,
-    }));
-  }}
-  components={{
-    Text: ({ text }) => <p>{text}</p>,
-    Group: ({ groupKey, indices, children }) => {
-      if (!groupKey) return <>{children}</>;
-      return (
-        <div className="parent-group">
-          <h4>Parent: {groupKey}</h4>
-          {children}
-        </div>
-      );
-    },
-  }}
-/>
-```
+{MessagePrimitiveDocs.GenerativeUI?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.GenerativeUI?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<ParametersTable
-  type="MessagePrimitive.Unstable_PartsGrouped.Props"
-  parameters={[
-    {
-      name: "groupingFunction",
-      required: true,
-      type: "GroupingFunction",
-      description:
-        "A function that receives the array of message parts and returns an array of groups. Each group has a groupKey (string or undefined for ungrouped parts) and an indices array of part positions.",
-    },
-    {
-      name: "components",
-      required: false,
-      type: "object",
-      description: "The components to render for each message part type and for group wrappers.",
-      children: [
-        {
-          parameters: [
-            {
-              name: "Text",
-              type: "TextMessagePartComponent",
-              description: "The component to render for each text message part.",
-            },
-            {
-              name: "Reasoning",
-              type: "ReasoningMessagePartComponent",
-              description: "The component to render for each reasoning message part.",
-            },
-            {
-              name: "Source",
-              type: "SourceMessagePartComponent",
-              description: "The component to render for each source message part.",
-            },
-            {
-              name: "Image",
-              type: "ImageMessagePartComponent",
-              description: "The component to render for each image message part.",
-            },
-            {
-              name: "File",
-              type: "FileMessagePartComponent",
-              description: "The component to render for each file message part.",
-            },
-            {
-              name: "Unstable_Audio",
-              type: "Unstable_AudioMessagePartComponent",
-              description: "The component to render for each audio message part.",
-            },
-            {
-              name: "Empty",
-              type: "EmptyMessagePartComponent",
-              description: "Component to render when the message has no parts.",
-            },
-            {
-              name: "tools",
-              type: "object",
-              description: "Configuration for tool call rendering.",
-              children: [
-                {
-                  parameters: [
-                    {
-                      name: "by_name",
-                      type: "Record<string, ToolCallMessagePartComponent>",
-                      description: "Map of tool names to their specific components.",
-                    },
-                    {
-                      name: "Fallback",
-                      type: "ToolCallMessagePartComponent",
-                      description:
-                        "Fallback component for tool calls not matched by by_name.",
-                    },
-                    {
-                      name: "Override",
-                      type: "ComponentType<ToolCallMessagePartProps>",
-                      description:
-                        "Override component that handles all tool calls. When set, by_name and Fallback are ignored.",
-                    },
-                  ],
-                },
-              ],
-            },
-            {
-              name: "data",
-              type: "object",
-              description: "Configuration for data part rendering.",
-              children: [
-                {
-                  parameters: [
-                    {
-                      name: "by_name",
-                      type: "Record<string, DataMessagePartComponent>",
-                      description:
-                        "Map of data event names to their specific components.",
-                    },
-                    {
-                      name: "Fallback",
-                      type: "DataMessagePartComponent",
-                      description:
-                        "Fallback component for data events not matched by by_name.",
-                    },
-                  ],
-                },
-              ],
-            },
-            {
-              name: "Group",
-              type: "ComponentType<PropsWithChildren<{ groupKey: string | undefined; indices: number[] }>>",
-              description:
-                "Component for rendering a group of message parts. Receives the groupKey (undefined for ungrouped parts), the indices of all parts in the group, and the rendered part children.",
-              children: [
-                {
-                  type: "GroupProps",
-                  parameters: [
-                    {
-                      name: "groupKey",
-                      type: "string | undefined",
-                      description:
-                        "The group key, or undefined for ungrouped parts.",
-                      required: true,
-                    },
-                    {
-                      name: "indices",
-                      type: "number[]",
-                      description:
-                        "Array of indices of the message parts belonging to this group.",
-                      required: true,
-                    },
-                    {
-                      name: "children",
-                      type: "ReactNode",
-                      description:
-                        "The rendered message part components within the group.",
-                      required: true,
-                    },
-                  ],
-                },
-              ],
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
+<ParametersTable {...MessagePrimitiveGenerativeUIProps} />
+
+### Unstable_PartsGrouped
+
+{MessagePrimitiveDocs.Unstable_PartsGrouped?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Unstable_PartsGrouped.deprecated}
+  </Callout>
+)}
+
+{MessagePrimitiveDocs.Unstable_PartsGrouped?.description}
+
+{MessagePrimitiveDocs.Unstable_PartsGrouped?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Unstable_PartsGrouped?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...MessagePrimitiveUnstable_PartsGroupedProps} />
 
 ### Unstable_PartsGroupedByParentId
 
-A convenience wrapper around `MessagePrimitive.Unstable_PartsGrouped` that groups message parts by their `parentId` field. Parts without a `parentId` appear individually at their chronological position; parts sharing the same `parentId` are collected into a single group at the position of their first occurrence.
+{MessagePrimitiveDocs.Unstable_PartsGroupedByParentId?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {MessagePrimitiveDocs.Unstable_PartsGroupedByParentId.deprecated}
+  </Callout>
+)}
 
-<Callout type="warn">
-This API is unstable and may change in a future release.
-</Callout>
+{MessagePrimitiveDocs.Unstable_PartsGroupedByParentId?.description}
 
-```tsx
-<MessagePrimitive.Unstable_PartsGroupedByParentId
-  components={{
-    Group: ({ groupKey, children }) => {
-      if (!groupKey) return <>{children}</>;
-      return (
-        <div className="parent-group border rounded p-4">
-          <h4>Parent ID: {groupKey}</h4>
-          {children}
-        </div>
-      );
-    },
-  }}
-/>
-```
+{MessagePrimitiveDocs.Unstable_PartsGroupedByParentId?.element && (
+  <p>This primitive renders a <code>{`<${MessagePrimitiveDocs.Unstable_PartsGroupedByParentId?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-Accepts the same `components` prop as [`MessagePrimitive.Unstable_PartsGrouped`](#unstable_partsgrouped), but without a `groupingFunction` prop (the parent-ID grouping function is applied automatically).
+<ParametersTable {...MessagePrimitiveUnstable_PartsGroupedByParentIdProps} />
 
-### Error
+### groupPartByType
+
+Build a `groupBy` from a `part.type → group-key path` lookup.
+Parts whose type isn't in the map are left ungrouped. The returned
+function carries a stable GROUPBY_MEMO_KEY fingerprint so
+`<MessagePrimitive.GroupedParts>` can memoize its tree across renders.
 
-Renders children only if the message has an error status.
+The synthetic `"standalone-tool-call"` key matches tool calls that should
+render outside the chain-of-thought grouping. MCP-app calls are detected from
+the part alone; the registry-driven cases (human tools, the generative-UI
+tool, `display: "standalone"` opt-ins) are resolved from the
+GroupByContext that `<MessagePrimitive.GroupedParts>` passes to the
+`groupBy` function — the helper needs nothing threaded into it.
 
 ```tsx
-<MessagePrimitive.Error>
-  {/* rendered if the message has an error status */}
-  <ErrorPrimitive.Root>
-    <ErrorPrimitive.Message />
-  </ErrorPrimitive.Root>
-</MessagePrimitive.Error>
+<MessagePrimitive.GroupedParts
+  groupBy={groupPartByType({
+    reasoning: ["group-thought", "group-reasoning"],
+    "tool-call": ["group-thought", "group-tool"],
+    "standalone-tool-call": [],
+  })}
+>
+  {({ part, children }) => { ... }}
+</MessagePrimitive.GroupedParts>
+```
+
+```ts
+const groupPartByType: <TKey extends `group-${string}`>(map: Partial<Readonly<Record<GroupPartType, readonly TKey[]>>>) => ((part: PartState, context?: GroupByContext) => readonly TKey[]);
 ```
+{/* api-reference:end */}