# Cloud Deployments 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/cloud-deployments-scene

## Governing rules

[Building with Socra components](https://socra.design/agents.md) explains setup, consumption rules and verification.

Semantic owner: Flash Module `ui-component-table` 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.

Cloud Console’s Deployments collection on declared example data.

Show Cloud doing work: Console’s Deployments page exactly as it lists a workload’s deployments, the image each one applied, when it was created and its status, scoped by Console’s own filter. The page passes the deployments; the scene owns Console’s anatomy and shows nothing Console does not.

Status: ready. Shared Cloud deployments scene (landing.CloudDeploymentsScene — Console’s page title and description, its filter Field and Input when the host scopes the list, and the Web UI Table collection with Console’s Resource, Details and Status columns: the image before its digest on ItemTitle, the created time and shortened Deployment ID on ItemDescription, and the status Chip in Console’s recipe; rows stack into labelled cells at phone width as Console’s grid does; inert, described in one label and captioned 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/cloud-deployments-scene/api.md)

### Setup

- Use one compatible Socra theme provider and published component styles.

### CloudDeploymentsScene

Import: `import { CloudDeploymentsScene } from '@socra/ui-web-landing';`

Cloud Console’s Deployments collection as Console lists it: the page title and description, the open filter when the host scopes the list, and one row per Deployment with its image, created time, shortened ID and status, framed and inert, labelled by its truth.

| Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector |
| --- | --- | --- | --- | --- | --- |
| `deployments` | `readonly CloudDeploymentsSceneDeployment[]` | Required input | yes | The Deployments, newest first as Console orders them. Each carries its complete id, the complete image reference including its digest, its status in Run’s words and its created time already formatted in the recording locale. Console titles each row by the image before its @sha256 digest on ItemTitle, sets the created time and the shortened Deployment ID (first ten characters, an ellipsis, last six) on ItemDescription, and prints the status on a small Chip: succeeded on the default Chip, failed on the destructive Chip, queued, running and cancelled on the outline Chip. The complete ID and image stay in the accessible description. | Direct API |
| `filter` | `string \| undefined` | Omitted; no declared default | no | The text in Console’s open filter, which matches Deployment IDs, statuses and images, such as a workload’s image name. When present, Console’s filter Surface renders above the collection with its Field label and a read-only Input holding the text; omitted, the list is unfiltered and no control renders. | Direct API |
| `label` | `string \| undefined` | Omitted; no declared default | no | A caption declaring example data or identifying a public source. Required for example data; never present example Deployments as a Socra Account’s. | Direct API |

### Behavior and constraints

- CloudDeploymentsSceneDeployment, CloudDeploymentsSceneStatus and CloudDeploymentsSceneProps are public type exports.
- The scene shows what Console’s Deployments page shows and nothing else: Console’s Run views record no actor, so no portrait or name appears in a row; the page around the scene says who deployed. Rows carry no links or actions; the title, description and column headers are text, never headings.
- Below 768px of container width the rows stack into labelled cells exactly as Console’s resource grid does on a phone. The scene fetches nothing from Run.

### Inspector mappings

| Setting | Initial preview value | Consumed code |
| --- | --- | --- |
| Newest deployment | `succeeded` | composition: Selects the status of the newest fictional Deployment (succeeded, running or failed) so the three Chip variants Console uses can be seen. It does not supply a status property; each Deployment carries its own. |
| Label | `Cloud Console with example data` | composition: Passes String(configuration.label ?? 'Cloud Console with example data').trim() \|\| that default to CloudDeploymentsScene.label, so a blank inspector value retains a truthful caption. The public label itself is optional without a default. |
| Filter to the workload | `true` | composition: Passes 'fieldnote-api' to CloudDeploymentsScene.filter when on and omits the property when off, so the specimen shows Console’s list scoped to one workload or unfiltered. |