@ds-mo/ui 9.1.0 → 9.2.0

package/dist/.build-stamp

@@ -1 +1 @@
-1784331945246
+1784503227826

package/dist/agent-patterns.json

@@ -1,9 +1,85 @@
 {
   "schemaVersion": "1.0.0",
   "package": "@ds-mo/ui",
-  "packageVersion": "9.1.0",
+  "packageVersion": "9.2.0",
   "kind": "patterns",
   "entries": [
+    {
+      "id": "pattern:agent-chat",
+      "status": "experimental",
+      "summary": "Extend the generic conversation pattern with ordered agent response parts while keeping transport and product behavior outside the design system.",
+      "useWhen": [
+        "A chat presents rich agent output including Markdown, safe activity, display-only tool calls, attachments, or sources."
+      ],
+      "avoidWhen": [
+        "The channel is person-to-person or the component would be expected to execute models, tools, approvals, or persistence."
+      ],
+      "components": [
+        {
+          "component": "component:ds-message-scroller",
+          "role": "Provides generic transcript movement and live-edge behavior.",
+          "required": true
+        },
+        {
+          "component": "component:ds-message",
+          "role": "Renders participant turns with channel-neutral semantics.",
+          "required": true
+        },
+        {
+          "component": "component:ds-message-bubble",
+          "role": "Renders participant copy with the shared body-medium regular message baseline.",
+          "required": true
+        },
+        {
+          "component": "component:ds-agent-response",
+          "role": "Renders ordered normalized agent response parts.",
+          "required": true
+        },
+        {
+          "component": "component:ds-message-composer",
+          "role": "Emits participant submission and stop intent.",
+          "required": true
+        }
+      ],
+      "stateOwnership": [
+        "The application owns scripted or real transport, immutable response parts, retry, stop, generated titles, and persistence.",
+        "Participant turns use MessageBubble's body-medium regular default; the application does not promote ordinary sent-message copy to body-large.",
+        "AgentResponse owns ordered display only and never reveals private reasoning.",
+        "Tool-call components display execution state but do not request participant approval."
+      ],
+      "accessibility": [
+        "Agent activity must be concise user-safe summaries, never hidden chain-of-thought.",
+        "Sources use descriptive external links and unsafe schemes remain non-interactive.",
+        "Streaming and tool states remain available as text without relying on animation."
+      ],
+      "responsiveBehavior": [
+        "Use wider ghost responses for rich content while retaining readable text measure and horizontal scrolling for code or tables."
+      ],
+      "implementations": {
+        "customElements": {
+          "status": "planned",
+          "references": [
+            "src/wc/components/MessageScroller/MessageScroller.stories.ts"
+          ]
+        },
+        "react": {
+          "status": "planned",
+          "references": [
+            "src/react/components.ts"
+          ]
+        },
+        "angular": {
+          "status": "planned",
+          "references": [
+            "src/angular/index.ts"
+          ]
+        }
+      },
+      "references": [
+        "agent/patterns/conversation/pattern.agent.json",
+        "src/wc/components/AgentResponse/AgentResponse.tsx"
+      ]
+    },
     {
       "id": "pattern:application-shell",
       "status": "experimental",
@@ -91,6 +167,94 @@
         "docs/framework-integration.md"
       ]
     },
+    {
+      "id": "pattern:conversation",
+      "status": "experimental",
+      "summary": "Compose channel-neutral history, transcript, message surfaces, attachments, and composer behavior for reusable conversations.",
+      "useWhen": [
+        "A product needs threaded conversation UX that may serve agent or person-to-person channels."
+      ],
+      "avoidWhen": [
+        "The experience is a static activity feed or form without conversational turns."
+      ],
+      "components": [
+        {
+          "component": "component:ds-conversation-list",
+          "role": "Owns history scrolling, empty layout, and floating action placement.",
+          "required": true
+        },
+        {
+          "component": "component:ds-panel-tool-search",
+          "role": "Collects a product-owned conversation history search query when the conversation is presented as a PanelTools product.",
+          "required": false
+        },
+        {
+          "component": "component:ds-message-scroller",
+          "role": "Owns transcript position and live-edge following.",
+          "required": true
+        },
+        {
+          "component": "component:ds-message",
+          "role": "Owns each turn's direction, grouping, and metadata.",
+          "required": true
+        },
+        {
+          "component": "component:ds-message-bubble",
+          "role": "Owns the visible content surface and body-medium default independently of row semantics.",
+          "required": true
+        },
+        {
+          "component": "component:ds-message-composer",
+          "role": "Emits draft, submit, and stop intent without transport ownership.",
+          "required": true
+        },
+        {
+          "component": "component:ds-attachment-list",
+          "role": "Displays existing attachment metadata when present.",
+          "required": false
+        }
+      ],
+      "stateOwnership": [
+        "The application owns conversations, messages, selection, drafts, persistence, transport, unread policy, and any history search query or matching policy. ConversationListItem presents every positive unreadCount as one dot aligned with the title row; unread titles are primary and read titles are secondary.",
+        "The application owns contextual row-menu commands such as pin, rename, members, and delete; ConversationListItem supplies the sibling actions slot and hover/focus/touch presentation.",
+        "When history search is present, distinguish an empty history from a populated history with no matching conversations.",
+        "Plain incoming and outgoing message copy uses MessageBubble's body-medium regular default; the application must not promote ordinary conversation turns to body-large.",
+        "MessageScroller owns reader-relative transcript position and follow behavior. Compose MessageComposer in its overlay slot so transcript content moves behind the surface while measured bottom clearance keeps the latest turn readable.",
+        "MessageComposer emits intent while the application controls its value and status. Its submit action defaults to brand for agent and person-to-person channels; select another submitIntent only for a different semantic consequence, never merely to identify AI content."
+      ],
+      "accessibility": [
+        "Give history and transcript regions distinct localized names.",
+        "Preserve message author, order, time, status, and delivery meaning in text.",
+        "Do not force the reader back to the live edge after deliberate transcript interaction."
+      ],
+      "responsiveBehavior": [
+        "Let the containing product select drawer or full-width layout while keeping transcript measure readable and rich content horizontally scrollable."
+      ],
+      "implementations": {
+        "customElements": {
+          "status": "planned",
+          "references": [
+            "src/wc/components/MessageScroller/MessageScroller.stories.ts"
+          ]
+        },
+        "react": {
+          "status": "planned",
+          "references": [
+            "src/react/components.ts"
+          ]
+        },
+        "angular": {
+          "status": "planned",
+          "references": [
+            "src/angular/index.ts"
+          ]
+        }
+      },
+      "references": [
+        "src/wc/components/ConversationList/ConversationList.stories.ts",
+        "src/wc/components/MessageScroller/MessageScroller.stories.ts"
+      ]
+    },
     {
       "id": "pattern:menu-trigger",
       "status": "stable",