# Inbox 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/inbox-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-inbox` 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. An AI teammate’s Cortex Inbox with Issues arriving one row at a time. Show where a teammate’s work lands: its own Cortex Inbox, exactly as Cortex’s Issues view renders it, each Issue with its status glyph, title, time and Module. The page passes the Issues; the scene renders the real Inbox at the width it is given and shows nothing Cortex does not. Status: ready. Shared inbox scene (landing.InboxScene — the Web UI Pane, AppBar, InboxList and InboxItem inside the shared HeroMediaFrame; each row is Cortex’s composition: the status recipe glyph as the leading badge, the title and time, the Module as the subtitle led by the priority glyph when there is one, no media; rows arrive one at a time from the first paint, once, with no script and no motion when the visitor asks for less; inert and described in one accessible label with the label beneath) 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/inbox-scene/api.md) ### Setup - Use the host-selected compatible Socra theme provider and published component styles. Keep one compatible provider instance across shared packages. ### InboxScene Import: `import { InboxScene } from '@socra/ui-web-landing';` An AI teammate’s own Cortex Inbox from the real Web UI Inbox rows, exactly as Cortex’s Issues view renders them: each Issue’s status glyph, title, time and Module. | 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\` the label only leads the scene's accessible description, for a page whose own words already say what the scene shows. | Direct API | | `issues` | `readonly InboxSceneIssue[]` | Required input | yes | The Issues, newest first: a stable id, the title, the Module that owns it, the time in Cortex’s own shapes (12m or 3h earlier today; Today, 3:52 PM for later today; Yesterday; a weekday; a date), the status (open, in_progress, done or canceled) and an optional priority (low, medium, high or urgent). Each Issue renders as the Web UI InboxItem as Cortex composes it: Cortex’s status recipe glyph as the one leading badge, the title with the time at its end, the Module as the subtitle led by the priority recipe glyph when the Issue has a priority. No media, no portraits and no kind glyphs, because Cortex’s Inbox shows none. | Direct API | | `label` | `string` | Required input | yes | What the scene is, stated beneath the frame and leading its accessible description. | Direct API | | `reveal` | `false`, `true` | `true` | no | Whether the rows arrive one at a time when the page loads. A CSS animation from the first paint, once, without script; prefers-reduced-motion shows the complete Inbox at once. false renders the settled frame. | Play once | | `title` | `string \| undefined` | `"Inbox"` | no | The Inbox title the pane shows. | 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 - InboxSceneIssue, InboxSceneStatus, InboxScenePriority and InboxSceneProps are public type exports. The status and priority glyphs and colors mirror Cortex’s own recipe (detailChips and cortexUi options on cortex-web main), so a row here is a row there. - The Inbox fills the column it is given, so a chapter can show it at full width; the rows are the real Inbox rows, inert and described in one role="img" label that reads every Issue with its status, title, Module, time and priority. - The fixture is three Issues in neutral Modules, one of them created by a schedule; product hosts pass their teammate’s Issues with real Module names and times in Cortex’s shapes. ### Inspector mappings | Setting | Initial preview value | Consumed code | | --- | --- | --- | | Inbox title | `Inbox` | composition: Passes String(configuration.title ?? 'Inbox').trim() \|\| 'Inbox' to InboxScene.title, so a blank inspector value retains the product’s title. | | Play once | `true` | InboxScene.reveal |