# Conversation Scene Agents: start with [Workspace for Agents](https://workspace.socra.com/solutions/agents.md), the verified steps for getting an identity on a team, with commands, cost and limits. Socra: Fill the roles your team needs with proactive AI teammates, each with its own computer, identity and role. Canonical: https://socra.design/landing/visuals/conversation-scene ## Governing rules [Building with Socra components](https://socra.design/agents.md) explains setup, consumption rules and verification. Semantic owner: Flash Module `ui-component-composition-conversation` in Socra Cortex when available. It supplies current intent and prerequisite rules; the public API below supplies exact code names and values. Use published property names, not inspector labels. Composition and preview settings are not component props. Public styling escape hatches do not permit product-local presentation overrides. A Channels exchange rendered with the real message components. Show people and AI teammates working in Channels with the product itself as the picture. The page passes the channel, the participants, the messages and the label that states what the scene is; the scene renders the real message list, mentions and attachments, plays once and holds still under reduced motion. Status: ready. Shared conversation scene (landing.ConversationScene — the Web UI Pane, AppBar, MessageList, MessageEntry, MessageProse, MemberMention and Attachment inside the shared HeroMediaFrame; each message carries the identity card and an AI teammate its chip; read in the channel, or as the thread Channels opens on a message: ConversationThread’s bar with Following and Close, the root message, the reply count on a labelled divider and the replies; a CSS reveal from the first paint, once, with no script and no motion when the visitor asks for less; an inert interface described in one accessible label; the required label beneath states illustrative or recorded) lives in @socra/ui-web-landing. Library: @socra/ui-web-landing ## Properties [Complete public API, including inherited properties and event signatures](https://socra.design/landing/visuals/conversation-scene/api.md) ### Setup - Use the host-selected compatible Socra theme provider and published component styles. Keep one compatible provider instance across shared packages. ### ConversationScene Import: `import { ConversationScene } from '@socra/ui-web-landing';` A Channels exchange rendered with the real Web UI message components inside the shared media frame: a channel, a direct message or a thread. | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `caption` | `false`, `true` | `true` | no | Whether the label is also stated beneath the scene as a caption. With \`false\` it only leads the scene's accessible description. | Direct API | | `channel` | `string \| undefined` | Omitted; no declared default | no | The channel’s name without its #, shown in the pane’s title, or beside the Thread title when the scene is a thread. Required for channel and thread; a direct message takes member instead. | Direct API | | `channelKind` | `"public"`, `"private"` | Omitted; no declared default | no | Whether the channel is public or private. Channel and thread only. @default public A private channel’s name follows the 16px lock, as Channels’ conversation header shows it; a public channel’s name stands alone. | Direct API | | `kind` | `"channel"`, `"thread"`, `"direct"` | `'channel'` | no | Whether the exchange is read in a channel, in a direct message with one member, or as a thread opened on its first message. channel renders channels-desktop’s header: the channel’s name as the AppBar’s title action with its chevron (a lock first for a private channel) and every message in one list; direct renders the member’s Avatar and their name as that title action instead, with every message in one list; thread renders Web UI ConversationThread’s bar (the Thread title, Following and Close), the first message as the root in its own list, the reply count Channels shows on a labelled divider (1 reply, 2 replies) and the remaining messages as the replies, each arriving one beat after the root. A thread keeps the measure of Channels’ thread pane, at most 560px wide and centered in its column, wherever a page places it. | Kind | | `label` | `string \| undefined` | Omitted; no declared default | no | An optional caption beneath the frame, such as An illustrative conversation or Recorded with the date, when the page’s owner asks for one. Never present an invented exchange as recorded. With a label, the figure shows it as its caption and the role="img" label opens with it. Without one, there is no caption and the description opens with what is visible: Conversation in #channel, Direct message with the member, or Thread from #channel. | Direct API | | `member` | `undefined \| string` | Omitted; no declared default | no | For a direct message, the id of the participant the conversation is with. Required for direct and must match a participant id; not accepted for channel or thread. Heads the pane as Channels heads a direct message: the member’s sm squircle Avatar in the AppBar’s leading slot, then their name as the AppBarTitleAction that opens the conversation’s details. | Direct API | | `messages` | `readonly ConversationSceneMessage[]` | Required input | yes | The exchange in reading order: a stable id, the author id, the time label, the text and an optional delivered file. Keep each message short enough to read at phone width. The attachment takes a file name and one short line. Each message renders as the Web UI MessageEntry with the author’s squircle Avatar, name, time and prose; a file renders as the Web UI Attachment with a file glyph. A message with a day renders Channels’ day boundary above it, the Web UI TimelineDay chip with that label (Monday, November 2). | Direct API | | `participants` | `readonly ConversationSceneParticipant[]` | Required input | yes | Everyone the messages name as an author: a stable id, a name, a kind of human or ai-teammate and an optional portrait URL. Every message’s author must match a participant id; an unknown author renders its id as the name without a portrait. An AI teammate’s messages carry the secondary sm AI teammate chip in the message header; a person’s carry none. A participant’s name, written as @Name inside any message, renders as the real MemberMention. | Direct API | | `portraitLoading` | `"eager"`, `"lazy"` | `"lazy"` | no | How the participants’ portraits load. Pass eager only for a scene on the first screen, such as a page hero. lazy sets loading="lazy" on every portrait. eager prioritizes only the leading message portrait (and a direct message’s header portrait); later message portraits remain lazy so a stacked phone hero does not preload below-screen media. | Direct API | | `reveal` | `false`, `true` | `true` | no | Whether the messages arrive one at a time when the page loads. The reveal is a CSS animation from the first paint, so the exchange is never shown and then hidden and plays once without script; prefers-reduced-motion shows the complete exchange at once. false renders the settled frame. | Play once | | `showProductMark` | `false`, `true` | Omitted; no declared default | no | Show the Channels product mark beside the channel name. | Direct API | | `teammateChip` | `false`, `true` | `true` | no | Whether an AI teammate's messages carry the \`AI teammate\` chip beside its name. Channels itself shows none in a message header; a page that tells its reader who is an AI teammate elsewhere passes \`false\` and shows the header exactly as Channels does, which also keeps the name, time and header on one line on a phone. | Direct API | ### Band Import: `import { Band } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `ariaLabelledby` | `string \| undefined` | Omitted; no declared default | no | id of the band's heading — keeps the
named for screen readers. | Direct API | | `bleed` | `false`, `true` | `false` | no | Band owns its full width (carousels): children render edge-to-edge with no content column. The child then re-creates the column where it needs one. | Direct API | | `children` | `ReactNode` | Required input | yes | | Direct API | | `colorMode` | `"dark"`, `"ambient"` | `"ambient"` | no | whether the band is fixed dark or follows the ambient page theme. | Direct API | | `contentMaxWidth` | `string \| undefined` | `"1120px"` | no | content column width; the production landing column. | Direct API | | `divider` | `false`, `true` | `false` | no | The divider at a standalone band's leading edge. Inside a marketing page the band sequence puts the divider on every boundary, so pages do not set it. | Direct API | | `id` | `string \| undefined` | Omitted; no declared default | no | anchor id for in-page navigation. | Direct API | | `spacing` | `"none"`, `"compact"`, `"screen"`, `"regular"` | `"regular"` | no | the band's vertical rhythm. | Direct API | | `tone` | `"base"`, `"surface"`, `"raised"` | `"base"` | no | A standalone band's surface step. Inside a marketing page the band sequence alternates base and surface by position, so pages do not set it. | Direct API | ### BandIntro Import: `import { BandIntro } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `align` | `"center"`, `"responsive"` | `"responsive"` | no | whether the column centers at every width or only from \`md\`. | Direct API | | `brand` | `ReactNode` | Omitted; no declared default | no | Optional product lockup above the heading. | Direct API | | `children` | `ReactNode` | Omitted; no declared default | no | extra intro content below the description (a second paragraph, a CTA). | Direct API | | `description` | `string \| undefined` | Omitted; no declared default | no | optional standfirst under the heading (\`subhead\` role). | Direct API | | `descriptionTone` | `"secondary"`, `"primary"` | `"primary"` | no | Supporting copy emphasis. | Direct API | | `headingScale` | `"section"`, `"statement"` | `'section'` | no | the heading scale. | Direct API | | `headingTreatment` | `"solid"`, `"gradient"` | `'gradient'` | no | the heading paint treatment. | Direct API | | `id` | `string \| undefined` | Omitted; no declared default | no | heading id — the target of the owning band's \`ariaLabelledby\`. | Direct API | | `level` | `"h1"`, `"h2"` | `'h2'` | no | the heading level; the page's first band passes 'h1'. | Direct API | | `title` | `ReactNode` | Required input | yes | the band heading, rendered through . | Direct API | ### Behavior and constraints - Use showProductMark on a channel scene to display the Channels logo beside its title. ConversationSceneParticipant, ConversationSceneMessage, ConversationSceneAttachment, ConversationSceneKind, ConversationSceneChannelProps, ConversationSceneDirectProps and ConversationSceneProps are public type exports. - The interface inside the frame is inert and hidden from assistive technology; the figure exposes one role="img" whose label names the place (after the caption, when there is one) and every message with its author, kind and time. The component owns no actions: nothing in it can be pressed, selected or focused. - The Direct message preview passes member="nova" in place of channel. - The fixture is a neutral fictional exchange between a person and an AI teammate, both shown by their initials: a real portrait appears only under its own name. Product hosts pass approved content and portraits and label a real exchange only after it is approved for publication. ### Inspector mappings | Setting | Initial preview value | Consumed code | | --- | --- | --- | | Kind | `channel` | ConversationScene.kind | | Label | `An illustrative conversation` | composition: Passes String(configuration.label ?? 'An illustrative conversation').trim() \|\| undefined to ConversationScene.label, so a blank inspector value shows the scene without a caption. | | Play once | `true` | ConversationScene.reveal |