@ds-mo/ui 13.13.0 → 13.15.0

package/dist/agent.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "1.0.0",
   "package": "@ds-mo/ui",
-  "packageVersion": "13.13.0",
+  "packageVersion": "13.15.0",
   "kind": "components",
   "entries": [
     {
@@ -80,19 +80,138 @@
         "text"
       ]
     },
+    {
+      "id": "component:ds-agent-questionnaire",
+      "tag": "ds-agent-questionnaire",
+      "name": "agent-questionnaire",
+      "title": "AgentQuestionnaire",
+      "summary": "Temporary multi-step work surface for provider-neutral agent clarification questions and durable read-only answer records.",
+      "intentStatus": "complete",
+      "intent": {
+        "audience": "specialized",
+        "status": "experimental",
+        "summary": "Temporary multi-step work surface for provider-neutral agent clarification questions and durable read-only answer records.",
+        "useWhen": [
+          "An agent turn pauses for one or more structured single-choice, multiple-choice, or free-text answers."
+        ],
+        "avoidWhen": [
+          "The interaction is a conventional application form, a tool authorization policy, or an application-owned approval with consequences beyond collecting answers."
+        ],
+        "commonlyComposedWith": [
+          "component:ds-message-scroller",
+          "component:ds-message-composer",
+          "component:ds-agent-response",
+          "component:ds-radio",
+          "component:ds-checkbox",
+          "component:ds-button-filled",
+          "component:ds-button-unfilled"
+        ],
+        "patterns": [
+          "pattern:agent-chat"
+        ],
+        "accessibility": [
+          "Radio and checkbox primitives own choice semantics, target density, keyboard interaction, and selected or disabled presentation; progress, validation relationships, static answered summaries, and every action remain available without relying on color or visual position.",
+          "The component never takes focus when it mounts; the application calls setFocus only when shifting focus is appropriate.",
+          "Choice rows use large Radio and Checkbox targets, while every navigation action uses a small Button primitive and Cancel is an icon-only Cross with localized tooltip and accessible name.",
+          "Selection primitives preserve focus, selected, invalid, and disabled distinctions in forced colors."
+        ],
+        "states": [
+          "The component owns only the current step, validation, and unsaved in-progress draft; the application owns the request, submission, transport, resume operation, persistence, and transcript replacement.",
+          "Preparing communicates that questions are being assembled, submitting locks editing without clearing the draft, error retains it with application feedback, and answered is a quiet noninteractive record.",
+          "A changed request identifier resets to the first question and seeds a fresh local draft from the supplied answers.",
+          "Questionnaire selection primitives are isolated from ancestor forms; only dsAnswer emits the normalized ordered answer collection."
+        ],
+        "responsiveBehavior": [
+          "Descriptive choices remain full-row targets, while actions collapse into a single-column layout at narrow widths."
+        ],
+        "references": [
+          {
+            "label": "Questionnaire state stories",
+            "path": "src/wc/components/AgentQuestionnaire/AgentQuestionnaire.stories.ts"
+          },
+          {
+            "label": "Agent chat composition",
+            "path": "agent/patterns/agent-chat/pattern.agent.json"
+          }
+        ]
+      },
+      "api": {
+        "props": {
+          "allowCancel": {
+            "type": "boolean",
+            "required": false
+          },
+          "answers": {
+            "type": "AgentQuestionAnswer[]",
+            "required": false
+          },
+          "errorMessage": {
+            "type": "string",
+            "required": false
+          },
+          "labels": {
+            "type": "Partial<AgentQuestionnaireLabels>",
+            "required": false
+          },
+          "questions": {
+            "type": "AgentQuestion[]",
+            "required": true
+          },
+          "requestId": {
+            "type": "string",
+            "required": true
+          },
+          "status": {
+            "type": "AgentQuestionnaireStatus",
+            "required": false
+          }
+        },
+        "events": [
+          {
+            "name": "dsAnswer",
+            "detail": "AgentQuestionnaireAnswerEventDetail"
+          },
+          {
+            "name": "dsCancel",
+            "detail": "AgentQuestionnaireCancelEventDetail"
+          }
+        ],
+        "slots": []
+      },
+      "exports": {
+        "customElement": "ds-agent-questionnaire",
+        "react": "DsAgentQuestionnaire",
+        "angular": "DsAgentQuestionnaire"
+      },
+      "dependencies": [
+        "@ds-mo/ui",
+        "@ds-mo/tokens",
+        "@ds-mo/icons"
+      ],
+      "componentDependencies": [
+        "button-filled",
+        "button-unfilled",
+        "checkbox",
+        "icon",
+        "loader",
+        "radio",
+        "text",
+        "tooltip"
+      ]
+    },
     {
       "id": "component:ds-agent-response",
       "tag": "ds-agent-response",
       "name": "agent-response",
       "title": "AgentResponse",
-      "summary": "Ordered renderer for normalized immutable agent response parts inside a generic incoming message.",
+      "summary": "Ordered renderer for normalized immutable agent response parts or an application-composed response body inside a generic incoming message.",
       "intentStatus": "complete",
       "intent": {
         "audience": "specialized",
         "status": "experimental",
-        "summary": "Ordered renderer for normalized immutable agent response parts inside a generic incoming message.",
+        "summary": "Ordered renderer for normalized immutable agent response parts or an application-composed response body inside a generic incoming message.",
         "useWhen": [
-          "An agent response combines Markdown, user-safe activity, display-only tools, attachments, and sources in authored order."
+          "An agent response combines Markdown, user-safe activity, display-only tools, attachments, answered questionnaires, sources, or application-specific content in authored order."
         ],
         "avoidWhen": [
           "The component would be expected to own a model, transport, persistence, title generation, approval policy, or private reasoning."
@@ -103,28 +222,30 @@
           "component:ds-markdown",
           "component:ds-agent-activity",
           "component:ds-agent-tool-call",
-          "component:ds-agent-source-list"
+          "component:ds-agent-source-list",
+          "component:ds-agent-questionnaire"
         ],
         "patterns": [
           "pattern:agent-chat"
         ],
         "accessibility": [
-          "Part order matches authored reading order and remains inside generic message semantics.",
+          "Part or composed-slot order matches authored reading order and remains inside generic message semantics.",
           "Streaming state supplements rather than replaces meaningful textual status.",
           "Forwarded metadata actions retain Message ordering, keyboard reveal, and touch visibility."
         ],
         "states": [
           "The owner replaces immutable part arrays as scripted or live output changes.",
+          "Parts mode remains the compatibility default for serializable content; composed mode ignores parts and gives the default slot ownership of the complete ordered response body.",
           "AgentResponse renders directly in Message without borrowing a plain MessageBubble surface.",
-          "Markdown parts use the optional safe renderer; prose CSS owns only semantic-tree styling and never response ordering or streaming state.",
+          "Markdown parts use the optional safe renderer; the response sets the public prose text measure while code, tables, tools, sources, attachments, and other structured parts retain the full lane.",
           "The application may compose MessageActions for completed-response Copy and controlled feedback while retaining persistent retry or recovery controls in the separate actions slot."
         ],
         "responsiveBehavior": [
-          "Rich content uses the available transcript width while respecting readable measure and local overflow constraints."
+          "Direct prose blocks use a readable text measure within the available transcript width, while narrow lanes and structured content retain their available width and local overflow constraints."
         ],
         "references": [
           {
-            "label": "Representative streamed response",
+            "label": "Response modes and representative flow",
             "path": "src/wc/components/AgentResponse/AgentResponse.stories.ts"
           },
           {
@@ -151,6 +272,10 @@
             "type": "AgentResponsePart[]",
             "required": false
           },
+          "renderMode": {
+            "type": "AgentResponseRenderMode",
+            "required": false
+          },
           "showAuthor": {
             "type": "boolean",
             "required": false
@@ -178,6 +303,7 @@
       ],
       "componentDependencies": [
         "agent-activity",
+        "agent-questionnaire",
         "agent-source-list",
         "agent-tool-call",
         "attachment-list",
@@ -190,17 +316,17 @@
       "tag": "ds-agent-source-list",
       "name": "agent-source-list",
       "title": "AgentSourceList",
-      "summary": "Collapsible list of agent response sources with title, description, and validated external links.",
+      "summary": "Inline collapsible agent-source list with safe external links, derived hostnames, optional descriptions, and observable disclosure state.",
       "intentStatus": "complete",
       "intent": {
         "audience": "specialized",
         "status": "experimental",
-        "summary": "Collapsible list of agent response sources with title, description, and validated external links.",
+        "summary": "Inline collapsible agent-source list with safe external links, derived hostnames, optional descriptions, and observable disclosure state.",
         "useWhen": [
-          "An agent response cites external material readers may inspect."
+          "A stable agent response cites external material readers may inspect inline."
         ],
         "avoidWhen": [
-          "The links are ordinary body links or are not sources for the response."
+          "The links are ordinary body links, source discovery is still active, or the application expects a source drawer or deduplication behavior."
         ],
         "commonlyComposedWith": [
           "component:ds-agent-response",
@@ -210,16 +336,20 @@
           "pattern:agent-chat"
         ],
         "accessibility": [
-          "Each source uses descriptive linked text and visible supporting context.",
-          "Unsafe link schemes remain non-interactive text."
+          "Each interactive source uses descriptive linked text, a visible hostname, supporting context, and an external-link indication.",
+          "Malformed and unsafe schemes remain non-interactive text rather than producing executable links.",
+          "The native disclosure exposes keyboard and expanded-state semantics, while open-change events let applications observe participant intent."
+        ],
+        "states": [
+          "Applications collect and deduplicate sources, then append the stable list once; active discovery remains an activity or tool state."
         ],
         "responsiveBehavior": [
-          "Source titles and descriptions wrap within the response width."
+          "Source titles, hostnames, and descriptions wrap within the response width."
         ],
         "references": [
           {
-            "label": "Storybook examples",
-            "path": "src/wc/components/MessageScroller/MessageScroller.stories.ts"
+            "label": "Source safety and disclosure stories",
+            "path": "src/wc/components/AgentSourceList/AgentSourceList.stories.ts"
           }
         ]
       },
@@ -238,7 +368,12 @@
             "required": false
           }
         },
-        "events": [],
+        "events": [
+          {
+            "name": "dsOpenChange",
+            "detail": "{ open: boolean }"
+          }
+        ],
         "slots": []
       },
       "exports": {
@@ -261,39 +396,50 @@
       "tag": "ds-agent-tool-call",
       "name": "agent-tool-call",
       "title": "AgentToolCall",
-      "summary": "Display-only disclosure for an agent tool call, its safe input or output, and execution status.",
+      "summary": "Compact display-only status row for a provider-neutral agent tool lifecycle with optional custom result and diagnostic disclosure surfaces.",
       "intentStatus": "complete",
       "intent": {
         "audience": "specialized",
         "status": "experimental",
-        "summary": "Display-only disclosure for an agent tool call, its safe input or output, and execution status.",
+        "summary": "Compact display-only status row for a provider-neutral agent tool lifecycle with optional custom result and diagnostic disclosure surfaces.",
         "useWhen": [
-          "A prototype or agent product needs to expose user-safe tool execution detail."
+          "An agent product needs to expose user-safe tool preparation, queueing, execution, participant wait, completion, failure, denial, or cancellation state."
         ],
         "avoidWhen": [
-          "A participant must approve, deny, edit, or retry the tool call; those are product controls outside this component."
+          "A participant must approve, deny, edit, retry, or execute the tool call; those product controls and consequences remain outside this component."
         ],
         "commonlyComposedWith": [
           "component:ds-agent-response",
-          "component:ds-code-block"
+          "component:ds-code-block",
+          "component:ds-text"
         ],
         "patterns": [
           "pattern:agent-chat"
         ],
         "accessibility": [
-          "Queued, running, success, error, and denied states are available as text.",
-          "The disclosure uses native keyboard and expanded-state semantics."
+          "Every lifecycle state remains visible as text and error or denied meaning does not depend on color.",
+          "A disclosure is rendered only when details exist and uses native keyboard and expanded-state semantics.",
+          "Structured input, output, and error details use the semantic code-family fallback and optional ligature override."
         ],
         "states": [
-          "This component presents state but never executes a tool or owns approval policy."
+          "Applications normalize provider-specific tool states and may localize the visible status label before rendering.",
+          "A custom summary replaces the generated name, a custom result owns the primary result surface, and custom details replace generic input, output, and error diagnostics.",
+          "An ordinary text-only custom result inherits the body-medium interface-text baseline; structured result components retain ownership of their own layout and typography.",
+          "Compose semantic links around ds-text when a custom result is navigational so anchor semantics and design-system typography each have one owner.",
+          "Applications load font assets once at their root; tool details and results never fetch or package a font.",
+          "This component presents state but never executes a tool or owns approval, retry, authorization, transport, or consequence policy."
         ],
         "responsiveBehavior": [
-          "Structured detail wraps and scrolls without widening the transcript."
+          "Long names and state labels wrap inside the compact row while custom results and structured diagnostics remain within the transcript lane without widening it."
         ],
         "references": [
           {
-            "label": "Storybook examples",
-            "path": "src/wc/components/MessageScroller/MessageScroller.stories.ts"
+            "label": "Lifecycle and slot stories",
+            "path": "src/wc/components/AgentToolCall/AgentToolCall.stories.ts"
+          },
+          {
+            "label": "Font ownership and loading",
+            "path": "docs/font-ownership.md"
           }
         ]
       },
@@ -326,9 +472,18 @@
           "state": {
             "type": "AgentToolState",
             "required": false
+          },
+          "statusLabel": {
+            "type": "string",
+            "required": false
           }
         },
-        "events": [],
+        "events": [
+          {
+            "name": "dsOpenChange",
+            "detail": "{ open: boolean }"
+          }
+        ],
         "slots": []
       },
       "exports": {
@@ -1467,7 +1622,7 @@
         ],
         "states": [
           "Every size applies one complete control-density recipe across frame height, inline padding, icon zone, text-container inset, gap, and radius.",
-          "Set isInset only when the button is nested inside a same-size control; it reduces the outer geometry while preserving the size's icon, label inset, gap, radius, and typography.",
+          "Set isInset only when the button is nested inside a same-size control. The default single inset removes 4px overall; insetDepth double removes 8px overall so the parent can add 4px per edge while preserving its outer alignment box. Double inset falls back to single at xs to protect minimum icon geometry.",
           "Use only one filled action per local decision area; render all secondary actions with ButtonUnfilled.",
           "Choose brand or neutral for general commands. Reserve positive, negative, warning, and caution for matching action consequences, and AI, guide, or walkthrough for actions that enter those feature experiences.",
           "Contrast serves both surface adaptation and hierarchy, but never permits a second filled action in the same decision area.",
@@ -1540,6 +1695,10 @@
             "type": "string",
             "required": false
           },
+          "insetDepth": {
+            "type": "ControlInsetDepth",
+            "required": false
+          },
           "intent": {
             "type": "ButtonFilledIntent",
             "required": false
@@ -1660,7 +1819,7 @@
         ],
         "accessibility": [
           "Provide an explicit accessible name for every icon-only action.",
-          "Set hasMenu when the button triggers a Menu; it implies aria-haspopup of menu. Pass controls with the Menu id and expanded from the same open state given to Menu.",
+          "Set hasMenu when the button triggers a Menu; it implies aria-haspopup of menu. Pass controls with the Menu id and expanded from the same open state given to Menu. Expanded popup triggers hold the pressed visual while open; expanded disclosure controls without popup semantics retain the normal resting appearance.",
           "Give an icon-only menu button an accessible name that states the role, such as More options, because no visible label or chevron carries it.",
           "Use haspopup directly for a non-menu popup such as a listbox or dialog; those cases get no chevron.",
           "Use pressed only for a genuine toggle button; it supplies aria-pressed and dsChange intent. Use isActive only for owner-controlled visual emphasis inside a composite whose selection semantics live on the owner.",
@@ -1671,7 +1830,7 @@
         ],
         "states": [
           "Every size applies one complete control-density recipe across frame height, inline padding, icon zone, text-container inset, gap, and radius.",
-          "Set isInset only when the button is nested inside a same-size control; it reduces the outer geometry while preserving the size's icon, label inset, gap, radius, and typography.",
+          "Set isInset only when the button is nested inside a same-size control. The default single inset removes 4px overall; insetDepth double removes 8px overall so the parent can add 4px per edge while preserving its outer alignment box. Double inset falls back to single at xs to protect minimum icon geometry.",
           "A true pressed toggle and owner-controlled isActive emphasis share the selected visual treatment, but only pressed supplies toggle semantics and dsChange.",
           "General content UI keeps the selected interaction fill and border for pressed or active emphasis.",
           "Shell, navigation, and tool-rail composites use isActive with foreground-only emphasis and no selected fill or border.",
@@ -1683,7 +1842,7 @@
           "Icon and icon-label loading replace the icon in place. Label-only loading centers the loader while preserving the button's measured width.",
           "hasMenu covers two distinct menu-button shapes and the variant selects between them. With label or icon-label the action has a menu, and a trailing chevron carries the affordance. With icon the button is a menu, meaning the overflow or more-options control, and no chevron is added.",
           "Because the icon-only shape has no chevron, its glyph must convey the menu on its own; use Ellipses. Never pair hasMenu with an icon-only glyph that does not read as a menu.",
-          "An open popup is a transient pressed state rather than a selected one. While expanded is true the pressed wash is held for the popup's complete rendered lifecycle and survives hover, including when chrome opts out of selected fills with activeFill set to false."
+          "An open popup is a transient pressed state rather than a selected one. While expanded is true and haspopup or hasMenu identifies a popup, the pressed wash is held for the popup's complete rendered lifecycle and survives hover, including when chrome opts out of selected fills with activeFill set to false. Expanded disclosure buttons without popup semantics remain visually neutral."
         ],
         "responsiveBehavior": [
           "The consuming layout decides when an icon-label action becomes icon-only and must provide an explicit accessible name after changing variants.",
@@ -1754,6 +1913,10 @@
             "type": "string",
             "required": false
           },
+          "insetDepth": {
+            "type": "ControlInsetDepth",
+            "required": false
+          },
           "isActive": {
             "type": "boolean",
             "required": false
@@ -2510,12 +2673,12 @@
       "tag": "ds-checkbox",
       "name": "checkbox",
       "title": "Checkbox",
-      "summary": "Form-associated checkbox for independent choices, acknowledgment, or consent, with checked, unchecked, mixed, and four density states.",
+      "summary": "Form-associated checkbox for independent choices, acknowledgment, or consent, with optional supporting description, checked, unchecked, mixed, and four density states.",
       "intentStatus": "complete",
       "intent": {
         "audience": "general",
         "status": "stable",
-        "summary": "Form-associated checkbox for independent choices, acknowledgment, or consent, with checked, unchecked, mixed, and four density states.",
+        "summary": "Form-associated checkbox for independent choices, acknowledgment, or consent, with optional supporting description, checked, unchecked, mixed, and four density states.",
         "useWhen": [
           "A user may independently select zero or more choices.",
           "A form requires acknowledgment, consent, or an opt-in value before submission.",
@@ -2549,7 +2712,7 @@
           "component:ds-text"
         ],
         "accessibility": [
-          "Every interactive checkbox requires a visible label that provides its accessible name.",
+          "Every interactive checkbox requires a visible label that provides its accessible name; an optional visible description is associated as supporting context.",
           "Enter and Space activate the checkbox; checked and mixed state are exposed through aria-checked.",
           "Disabled and inactive checkboxes leave the tab order and are omitted from form submission.",
           "Use presentation mode only inside a composite option that owns selection semantics, focus, and interaction."
@@ -2559,16 +2722,17 @@
           "Activating an indeterminate checkbox clears the mixed state, toggles checked, and emits dsChange with the resulting boolean.",
           "The initial checked and indeterminate values are restored by native form reset; checked values submit under name and unchecked values submit nothing.",
           "Sizes are lg with a 20px box in a 24px placement, md with a 16px box in a 20px placement, sm with a 12px box in a 16px placement, and xs with an 8px box in a 12px placement.",
-          "Presentation mode removes checkbox semantics, focus, interaction, label rendering, and form submission while preserving the visual state."
+          "Presentation mode removes checkbox semantics, focus, interaction, label rendering, description rendering, and form submission while preserving the visual state.",
+          "Description-rich checkboxes grow beyond the fixed density height while retaining its minimum target size and primitive-owned selection anatomy."
         ],
         "responsiveBehavior": [
-          "Choose size from the density of the containing row; labels may wrap while the placement box stays fixed.",
+          "Choose size from the density of the containing row; labels and descriptions may wrap while the placement box stays fixed.",
           "Use the same density as the shared option icon zone in multi-select rows."
         ],
         "frameworkCaveats": {
           "customElements": [
             "Bind checked and indeterminate as properties for application state updates and listen for dsChange.",
-            "Use the form attribute on the host when associating a checkbox rendered outside its owning form."
+            "Use the form attribute on the host when associating a checkbox rendered outside its owning form or isolating it from an ancestor form."
           ],
           "react": [
             "Use DsCheckbox and handle onDsChange; checked and indeterminate are mutable and update after user activation."
@@ -2594,6 +2758,10 @@
             "type": "boolean",
             "required": false
           },
+          "description": {
+            "type": "string",
+            "required": false
+          },
           "disabled": {
             "type": "boolean",
             "required": false
@@ -2793,12 +2961,12 @@
       "tag": "ds-code-block",
       "name": "code-block",
       "title": "CodeBlock",
-      "summary": "Scrollable monospace code surface with optional language or filename context and copy action.",
+      "summary": "Scrollable code surface with optional language or filename context and copy action.",
       "intentStatus": "complete",
       "intent": {
         "audience": "general",
         "status": "experimental",
-        "summary": "Scrollable monospace code surface with optional language or filename context and copy action.",
+        "summary": "Scrollable code surface with optional language or filename context and copy action.",
         "useWhen": [
           "A message or document displays fenced code that readers may copy."
         ],
@@ -2811,7 +2979,11 @@
         ],
         "accessibility": [
           "The copy action has matching accessible-name and visible-tooltip status wording, and the code remains selectable text.",
-          "Language and filename labels supplement rather than replace the code content."
+          "Language and filename labels supplement rather than replace the code content.",
+          "The semantic code-family token retains a system-monospace fallback when an application does not load Fira Code; applications may disable programming ligatures through the shared code-surface custom property."
+        ],
+        "states": [
+          "Applications load font assets once at their root. The component consumes --typography-font-family-code and never fetches or packages a font."
         ],
         "responsiveBehavior": [
           "Long lines scroll horizontally and do not widen the owning transcript."
@@ -2819,7 +2991,11 @@
         "references": [
           {
             "label": "Storybook examples",
-            "path": "src/wc/components/MessageScroller/MessageScroller.stories.ts"
+            "path": "src/wc/components/CodeBlock/CodeBlock.stories.ts"
+          },
+          {
+            "label": "Font ownership and loading",
+            "path": "docs/font-ownership.md"
           }
         ]
       },
@@ -4418,12 +4594,12 @@
       "tag": "ds-message-composer",
       "name": "message-composer",
       "title": "MessageComposer",
-      "summary": "Two-line auto-growing conversation textarea with submit, stop, error, and extensible leading-tool or trailing-action regions.",
+      "summary": "Two-line auto-growing conversation textarea with submit, stop, an attached submission-error support surface, and extensible tool, action, and error-recovery regions.",
       "intentStatus": "complete",
       "intent": {
         "audience": "general",
         "status": "experimental",
-        "summary": "Two-line auto-growing conversation textarea with submit, stop, error, and extensible leading-tool or trailing-action regions.",
+        "summary": "Two-line auto-growing conversation textarea with submit, stop, an attached submission-error support surface, and extensible tool, action, and error-recovery regions.",
         "useWhen": [
           "A conversation accepts multi-line text and needs Enter-to-submit with a streaming stop action."
         ],
@@ -4441,14 +4617,17 @@
         "accessibility": [
           "Always provide a localized textarea label and submit or stop action names; the built-in icon action exposes the same name in its tooltip.",
           "Shift plus Enter inserts a newline while Enter submits non-empty content.",
-          "Streaming and error states remain perceivable without relying on icon shape alone."
+          "Submission errors remain visible and announced above the editable box as part of one attached composer unit, and the editable control references their text while the error state is active.",
+          "Streaming and error states remain perceivable without relying on icon shape or color alone."
         ],
         "states": [
           "The owner controls draft value and transport state; the composer emits intent without performing transport.",
+          "Error status never clears or disables the draft; the application supplies recovery actions through error-actions and owns retry semantics. The negative support surface appears above and attached to the composer box, within the component's measured ownership.",
           "Use the tools slot for leading actions such as add and the actions slot for trailing actions such as dictation; the built-in submit or stop action remains last with an 8px gap from the preceding action. These icon buttons use the standard non-rounded control radius, and the application supplies tooltips for slotted icon actions.",
           "The composer surface uses the 10px --dimension-radius-125 token.",
           "Mouse or keyboard focus on the textarea gives the complete composer surface the same bold-brand inset stroke width and color as an active Input; the native textarea never draws a separate outline.",
-          "The empty or otherwise inactive submit action is a disabled bordered ButtonUnfilled. Ready submit actions use submitIntent, while the streaming stop action remains a bold-brand ButtonFilled."
+          "The empty or otherwise inactive submit action is a disabled bordered ButtonUnfilled. Ready submit actions use submitIntent, while the streaming stop action remains a bold-brand ButtonFilled.",
+          "The attached error unit keeps a real boundary in forced colors and lets message text and application-owned recovery actions wrap at narrow widths."
         ],
         "responsiveBehavior": [
           "The textarea begins at two body-medium lines, grows one line at a time through six lines, and then scrolls internally."
@@ -4466,6 +4645,10 @@
       },
       "api": {
         "props": {
+          "errorMessage": {
+            "type": "string",
+            "required": false
+          },
           "isInactive": {
             "type": "boolean",
             "required": false
@@ -4514,11 +4697,14 @@
       },
       "dependencies": [
         "@ds-mo/ui",
-        "@ds-mo/tokens"
+        "@ds-mo/tokens",
+        "@ds-mo/icons"
       ],
       "componentDependencies": [
         "button-filled",
         "button-unfilled",
+        "icon",
+        "text",
         "tooltip"
       ]
     },
@@ -4527,12 +4713,12 @@
       "tag": "ds-message-scroller",
       "name": "message-scroller",
       "title": "MessageScroller",
-      "summary": "Focusable transcript scroller that follows the live edge only while the reader remains there.",
+      "summary": "Focusable transcript scroller with turn anchoring, reader-controlled live-edge following, and a measured interaction-plus-composer overlay stack.",
       "intentStatus": "complete",
       "intent": {
         "audience": "general",
         "status": "experimental",
-        "summary": "Focusable transcript scroller that follows the live edge only while the reader remains there.",
+        "summary": "Focusable transcript scroller with turn anchoring, reader-controlled live-edge following, and a measured interaction-plus-composer overlay stack.",
         "useWhen": [
           "Messages can append or stream and transcript position must remain respectful of reader intent."
         ],
@@ -4541,10 +4727,12 @@
         ],
         "commonlyComposedWith": [
           "component:ds-message",
-          "component:ds-message-composer"
+          "component:ds-message-composer",
+          "component:ds-agent-questionnaire"
         ],
         "patterns": [
-          "pattern:conversation"
+          "pattern:conversation",
+          "pattern:agent-chat"
         ],
         "accessibility": [
           "Give each transcript a concise localized label.",
@@ -4552,11 +4740,12 @@
           "The scroll-to-latest control remains keyboard accessible when follow behavior is released and exposes its action name in a tooltip."
         ],
         "states": [
-          "Selection and transcript interaction release automatic following.",
+          "Wheel, touch, keyboard navigation, selection, and transcript interaction release automatic following; Scroll to latest explicitly restores it.",
+          "A newly appended outgoing Message marked scroll-anchor starts a turn near the top with the configurable previous-turn peek; mutations inside existing messages and prepended history do not re-anchor.",
           "Opening saved history, message jumps, and prepended history preserve deliberate position.",
           "The scroll-to-latest action is absent at the live edge, appears only after the reader moves away, and disappears again after returning to the newest message.",
           "Scroll to latest uses the shared md control-elevation wrapper with a pointer-transparent top highlight, preserving its transparent backdrop blur and borderless unfilled action while the press-scale modifier moves the complete elevated surface.",
-          "Place a composer container with 8px padding on every side in the overlay slot so messages scroll behind it; the shared scroll-overlay controller tracks every composer growth step, reserves matching transcript clearance, begins the fade 8px before the visible composer, and keeps scroll-to-latest above it."
+          "Place a pending human-input surface in interaction and a composer container with 8px padding on every side in overlay; the shared scroll-overlay controller measures them as one stack, tracks every growth step, reserves matching transcript clearance, begins the fade before the stack, and keeps scroll-to-latest above it."
         ],
         "responsiveBehavior": [
           "Transcript width is readable while the scroll region fills available height.",
@@ -6054,12 +6243,12 @@
       "tag": "ds-radio",
       "name": "radio",
       "title": "Radio",
-      "summary": "Form-associated one-of-many radio selection set with vertical or horizontal layout, four densities, per-option inactive state, and roving keyboard focus.",
+      "summary": "Form-associated one-of-many radio selection set with vertical or horizontal layout, optional per-option descriptions, four densities, per-option inactive state, and roving keyboard focus.",
       "intentStatus": "complete",
       "intent": {
         "audience": "general",
         "status": "stable",
-        "summary": "Form-associated one-of-many radio selection set with vertical or horizontal layout, four densities, per-option inactive state, and roving keyboard focus.",
+        "summary": "Form-associated one-of-many radio selection set with vertical or horizontal layout, optional per-option descriptions, four densities, per-option inactive state, and roving keyboard focus.",
         "useWhen": [
           "A user must select exactly one visible option from a small set.",
           "All available choices should remain visible for comparison.",
@@ -6093,19 +6282,20 @@
         ],
         "accessibility": [
           "The host exposes radiogroup semantics and requires an accessible group name from aria-label or aria-labelledby.",
-          "Each visible option exposes radio semantics, its checked state, its label text, and any inactive state.",
+          "Each visible option exposes radio semantics, its checked state, its label text, optional supporting description, and any inactive state.",
           "Arrow keys move and select through active options; Home and End select the first and last active options; Space and Enter select the focused option.",
-          "Roving tabindex keeps one active option in the tab order, preferring the selected option."
+          "Roving tabindex keeps one active option in the tab order, preferring the selected option; setFocus uses that same public focus target."
         ],
         "states": [
           "Unchecked circles use a tertiary-foreground inset stroke: 1.5px at lg, 1.25px at md, 1px at sm, and 0.75px at xs.",
           "Selected circles remove the border, use a brand fill, and draw a centered on-bold foreground dot sized 10px at lg, 8px at md, 6px at sm, and 4px at xs.",
           "Sizes are lg with a 20px circle in a 24px placement, md with a 16px circle in a 20px placement, sm with a 12px circle in a 16px placement, and xs with an 8px circle in a 12px placement.",
-          "The initial value is restored by native form reset; the selected value submits under name and a required set is invalid until one active option is selected."
+          "The initial value is restored by native form reset; the selected value submits under name and a required set is invalid until one active option is selected.",
+          "Description-rich options grow beyond the fixed density height while retaining its minimum target size and primitive-owned selection anatomy."
         ],
         "responsiveBehavior": [
           "Choose size from the density of the containing form or settings row.",
-          "Prefer vertical layout when labels may wrap or horizontal space is constrained; horizontal layout is appropriate for short labels in a small set."
+          "Prefer vertical layout when labels or descriptions may wrap or horizontal space is constrained; horizontal layout is appropriate for short labels in a small set."
         ],
         "frameworkCaveats": {
           "customElements": [
@@ -7880,23 +8070,24 @@
           "component:ds-icon"
         ],
         "accessibility": [
-          "The rendered structure uses a native table, caption, column headers, row groups, and data cells; keep the caption non-empty even when it is visually hidden.",
+          "The rendered structure uses a native table, caption, column headers, row groups, and data cells; keep the caption non-empty. The native caption remains visually hidden as the table's accessible name. When caption visibility is enabled, a presentational title bar renders as component chrome outside the horizontal scrollport so it stays aligned with the table frame without duplicating the accessible name.",
           "Sorting controls remain buttons inside column headers. Member-row sort uses aria-sort, while independent group order is described by the grouped header control.",
-          "Selection controls expose checkbox semantics and explicit row names; select-all affects selectable loaded rows only and preserves selected identities outside the loaded window.",
+          "Selection controls expose checkbox semantics and explicit row names; select-all affects selectable loaded rows only and preserves selected identities outside the loaded window. When grouping is active with multi-selection, each group section header also exposes a checkbox that selects or clears that group's selectable loaded rows.",
           "Interactive rows are focusable as native rows, activate with Enter or Space, and do not steal activation from their nested selection or action controls.",
           "Scrollable table regions become keyboard focusable and named only when overflow exists.",
-          "Incremental loading, newly appended row counts, failures, and end-of-results transitions are announced through a polite status region without replacing visible state."
+          "Incremental loading, newly appended row counts, failures, and end-of-results transitions are announced through a polite status region without replacing visible state.",
+          "An optional result summary footer appears below the table frame when both displayedCount and totalCount are finite, formatting Displaying {displayed} of {total} in text-body-medium secondary."
         ],
         "states": [
-          "Columns, rows, groups, grouping, sorting, selected row IDs, and lazy-loading state are controlled inputs. Events communicate intent and never mutate those inputs.",
-          "Grouping supports one level. The application supplies ordered groups and ordered member rows; group order and member-row sort are independent controls.",
+          "Columns, rows, groups, grouping, sorting, selected row IDs, collapsed group IDs, displayedCount, totalCount, and lazy-loading state are controlled inputs. Events communicate intent and never mutate those inputs.",
+          "Grouping supports one level. The application supplies ordered groups and ordered member rows; group order and member-row sort are independent controls. Group section headers show an emphasized text-body-medium label followed by a rounded sm Tag containing only the numeric count. The Tag uses the group's faint intent surface (neutral when intent is absent) and a small-elevation, button-hugging wrapper; a localized countLabel remains available to assistive technology. Groups may declare an optional intent (brand, neutral, negative, warning, caution, positive) that paints an LTR gradient from the faint intent surface at the label edge into faint neutral at the trailing edge, plus a bold intent title color. Neutral groups remain solid faint neutral. Section separators are painted inside that viewport-width surface so translucent border tokens composite with each intent background; the final collapsed section does not duplicate the terminal table edge. A trailing visually neutral icon-only ButtonUnfilled uses the 24px md double-inset action recipe and toggles controlled collapsedGroupIds, showing ChevronUp while expanded and ChevronDown while collapsed. While any group remains expanded, a ChevronDownUp action uses the xs sort-control recipe widened to a table-owned 24px lane and collapses every group. It appears at the inline-end edge of the trailing column declared with kind action when one exists; otherwise a button-hugging 24px by 16px medium-elevation surface floats at the visible scrollport's header edge so the action remains reachable while member columns scroll beneath it. The section header stays pinned to the visible horizontal scrollport and spans the smaller of the visible viewport or table width.",
           "An active member sort toggles only between ascending and descending; activating a different sortable label moves sorting to that key. Applications may still clear the controlled sort state explicitly. The grouped column toggles ascending and descending group order without clearing member sort.",
           "Compound headers can expose multiple related labels with independent sort keys. Each label owns only its content-width interaction target while the active direction remains in the column's alignment-aware sort lane.",
-          "Initial loading uses row-shaped skeletons. Empty and initial error states remain inside the table. Incremental loading retains existing rows and supports automatic sentinel, manual load-more, retry, and terminal states.",
+          "Initial loading uses row-shaped skeletons that preserve the standard single-line cell padding, row dividers, column dividers, selection lane, and sticky-lane boundaries. Empty and initial error states remain inside the table. Incremental loading retains existing rows and supports automatic sentinel, manual load-more, retry, and terminal states.",
           "Lazy loading replaces pagination. The application owns requests, cancellation, cursors, deduplication, appended records, and query identity; loadIdentity resets the component request guard.",
           "Rows opt into complete-row activation with interactive and emit dsRowActivate without owning navigation. Selection paints through the shared selected ::before layer; interactive hover and press paint through the shared ::after layer.",
           "Row selection owns the single sticky start lane. One explicitly sized application column can own the sticky end lane, or the start lane when selection is absent. Each sticky boundary owns one fixed divider and a row-clipped directional shadow that paints into the adjacent scrolling columns only while more inline content remains beyond that edge.",
-          "Cells accept scalar content, standard primary-and-secondary or dual-primary text primitives, declarative Tag, icon-only, 16:9 Image, or ButtonUnfilled Action content, or explicit Empty and Blank absence values. Single-track text, selection, tag-only, icon-only, Action, Empty, and Blank cells resolve a 40px base contract while multi-track cells grow downward. Action cells primarily use an icon-only Ellipses treatment, render a 24px small ButtonUnfilled inside 8px padding, default to unbordered, and emit row, column, and action identities through dsCellAction. Image cells render a 52px-high bordered preview inside 6px outer padding, establishing a 64px row, and fall back to an accessible placeholder when no source is supplied. Empty means the data applies but has no value and renders an em dash with localized assistive text; Blank means the data is not applicable and renders no content. Nullish values remain backward-compatible Empty values. Stable type and variant hooks keep every cell family independently styleable.",
+          "Cells accept scalar content, standard primary-and-secondary or dual-primary text primitives, declarative Tag, icon-only, 16:9 Image, or ButtonUnfilled Action content, or explicit Empty and Blank absence values. Single-track text, selection, tag-only, icon-only, Action, Empty, and Blank cells resolve a 40px base contract while multi-track cells grow downward. Tag cells use the double-inset Tag recipe; the md tag-only recipe is 24px inside 8px padding, while compound tag tracks preserve their peer text alignment. Action cells primarily use an icon-only Ellipses treatment, render a 24px small ButtonUnfilled inside 8px padding, default to unbordered, and emit row, column, and action identities through dsCellAction. Image cells render a 48px-high 16:9 bordered preview inside 8px outer padding, establishing a 64px row and a 102px column recipe, and fall back to an accessible placeholder when no source is supplied. Empty means the data applies but has no value and renders an em dash with localized assistive text; Blank means the data is not applicable and renders no content. Nullish values remain backward-compatible Empty values. Stable type and variant hooks keep every cell family independently styleable.",
           "The public @ds-mo/ui/table.css export is the authoritative zero-specificity visual recipe. Override its --ds-table-* properties or target its stable element classes for product-specific styling."
         ],
         "responsiveBehavior": [
@@ -7910,12 +8101,12 @@
         ],
         "frameworkCaveats": {
           "customElements": [
-            "Assign columns, rows, groups, grouping, sort, and selectedRowIds through JavaScript properties rather than HTML attribute strings.",
-            "Replace controlled property values in response to dsSortChange, dsGroupingChange, dsSelectionChange, and dsLoadMore; route dsRowActivate in the application owner."
+            "Assign columns, rows, groups, grouping, sort, selectedRowIds, collapsedGroupIds, displayedCount, and totalCount through JavaScript properties rather than HTML attribute strings.",
+            "Replace controlled property values in response to dsSortChange, dsGroupingChange, dsGroupCollapseChange, dsSelectionChange, and dsLoadMore; route dsRowActivate in the application owner."
           ],
           "react": [
             "Pass new array and state-object references when the controlled data or query state changes.",
-            "Apply emitted sort, grouping, selection, action, or loading detail to application state and perform data transformations in the owning layer."
+            "Apply emitted sort, grouping, collapse, selection, action, or loading detail to application state and perform data transformations in the owning layer."
           ],
           "angular": [
             "Bind complex table inputs as properties and update the controlled values from the corresponding output events.",
@@ -7943,10 +8134,18 @@
             "type": "TableCaptionVisibility",
             "required": false
           },
+          "collapsedGroupIds": {
+            "type": "string[]",
+            "required": false
+          },
           "columns": {
             "type": "TableColumn[]",
             "required": false
           },
+          "displayedCount": {
+            "type": "number | undefined",
+            "required": false
+          },
           "emptyBody": {
             "type": "string",
             "required": false
@@ -8027,6 +8226,10 @@
             "type": "string | number | undefined",
             "required": false
           },
+          "resultSummaryLabel": {
+            "type": "string",
+            "required": false
+          },
           "retryLabel": {
             "type": "string",
             "required": false
@@ -8062,6 +8265,10 @@
           "stickyHeader": {
             "type": "boolean",
             "required": false
+          },
+          "totalCount": {
+            "type": "number | undefined",
+            "required": false
           }
         },
         "events": [
@@ -8069,6 +8276,10 @@
             "name": "dsCellAction",
             "detail": "TableCellActionDetail"
           },
+          {
+            "name": "dsGroupCollapseChange",
+            "detail": "TableGroupCollapseChangeDetail"
+          },
           {
             "name": "dsGroupingChange",
             "detail": "TableGroupingChangeDetail"
@@ -8172,8 +8383,8 @@
           "Neutral is ordinary metadata; brand marks Motive or product affiliation; AI marks AI-generated or AI-assisted content; positive, caution, warning, and negative communicate increasingly specific status meaning.",
           "Warning signals higher urgency or risk than caution, which asks for attention before a possible issue.",
           "Contrast changes visual prominence without changing semantic intent or parent surface context.",
-          "Rounded is an optional visual style with no semantic difference.",
-          "isInset opts into reduced outer geometry only when Tag is nested inside a control of the same density; semantic styling, typography, icons, gaps, radius, and interaction remain unchanged.",
+          "Rounded is an optional visual style with no semantic difference. Every size and inset depth keeps a minimum inline size equal to its resolved height, so short labels such as a one-digit count render as circles instead of vertically elongated pills.",
+          "isInset opts into reduced outer geometry only when Tag is nested inside a control of the same density. The default single inset removes 4px overall; insetDepth double removes 8px overall and falls back to single at xs to protect minimum icon geometry. Semantic styling, typography, icons, gaps, radius, and interaction remain unchanged.",
           "Labels stay on one line and truncate only when the owner supplies a maximum width.",
           "Omitted interactive renders static metadata with no focus, event, or suffix. Interactive adds the fixed ChevronUpDown suffix and emits dsClick without toggling expanded internally.",
           "isInactive disables only the interactive button and applies the shared inactive treatment."
@@ -8218,6 +8429,10 @@
             "type": "string",
             "required": false
           },
+          "insetDepth": {
+            "type": "ControlInsetDepth",
+            "required": false
+          },
           "intent": {
             "type": "TagIntent",
             "required": false
@@ -8785,6 +9000,8 @@
           "The owning chart mounts the callout when a local interaction starts and unmounts it when that interaction ends.",
           "Coordinate updates track within one mounted interaction session without restarting the show delay.",
           "Placement flips horizontally or vertically when the rendered callout approaches a viewport edge.",
+          "The heading and rows use the same medium-density section-heading and control-frame anatomy as menu-style choice content.",
+          "When any grouped row supplies a swatch, every row reserves the shared leading icon zone so mixed-swatch labels and trailing values stay aligned.",
           "Placement is chosen as a quadrant rather than computed as coordinates: the component measures its own rendered rect and flips its side and align props, which CSS consumes. It therefore does not use the shared anchored-position utilities, which resolve an anchor element into x and y.",
           "This separation is deliberate. The callout follows the pointer instead of an element, so it has no anchor rect to resolve; adopting the shared geometry would mean rewriting its CSS to consume coordinates for no behavioral gain.",
           "Reduced motion preserves the final visible state without an opacity transition."