Studio Surface Runtime

This file keeps its historical filename for existing doc links. The runtime now serves owner-scoped Studio Engines and OS Runtime containers.

Runtime Flow

app registry
  -> optional manifest surfaceCapabilities
  -> os-surface fallback overrides
  -> WorkspaceSurfaceManifest[]
  -> DesktopSurfaceRoot
  -> owner-scoped Runtime or Studio renderer

DesktopSurfaceRoot selects a renderer from the current route and local Shell state. Public Studio routes use /@user/studios/:studioSlug, OS Runtime routes use /@user/runtime/:runtimeSlug, and local development engines live under /dev/studios/*.

Routes

Route	Purpose
`/studio`	User-facing AI Entry for creating the first Prox Studio.
`/@user`	Universe page for profile, Runtime, Studio, app, and Space discovery.
`/@user/runtime/:runtimeSlug`	Owner-scoped Runtime root.
`/@user/runtime/:runtimeSlug/:runtimeMode`	Runtime Command Strip mode routes.
`/@user/studios/atlas`	Atlas Studio route.
`/@user/studios/grid`	Grid Studio route.
`/@user/studios/ops`	Ops Studio route.
`/dev`	Local developer workbench.
`/dev/studios/:engine`	Local-only development engine route.

Historical development-only Runtime and Studio route families are not kept as legacy redirects.

Renderers

Mode	Renderer host/package	Current scope
`desktop`	`apps/os-shell`	OS Runtime windows, folders, Dock, Mission Control, and runtime Scenes.
`atlas`	`apps/os-shell`	Collections, knowledge landscape, recent paths, and cards.
`grid`	`apps/os-shell`	Draggable dashboard widgets and projections.
`ops`	`apps/os-shell`	Metrics, records, admin checks, review queues, and operator workflows.
local-only engines	`apps/os-shell` and extracted engine packages	Site, Webview, Device, CLI, Admin, Block, Flow, Board, IDE, and App Studio experiments under `/dev/studios/*`.

DesktopSurfaceRoot lazy-loads CLI, Block, Flow, and Board so xterm, BlockNote, Excalidraw, and React Flow do not enter the Shell initial bundle.

Workspace Geometry

Every non-Desktop renderer still sets data-os-core-workspace on the core workspace container. This preserves Alma-aware placement for workspace-local surfaces such as Switchbar, Slidepad, and floating engine tools.

Alma remains outside the workspace column and is positioned by Platform Options. Runtime Command Strip placement is runtime-local and should not move Platform Navigation.

Persistence Direction

The current runtime stores the active route and owner graph locally. Later phases can persist Runtime records, Studio records, per-engine layouts, dataset bindings, app placements, permissions, and collaboration state through backend user preferences and resource APIs.