IPC protocol 0.4
Schema reference / IPC protocol / 0.4
JSON-RPC 2.0 frames between core and shells, SDK clients and tools: every method’s params and result, notifications, state and errors.
Raw schema
Loading ipc.schema.json…Changes since 0.3
Changelog · 0.4.0 (M2)
- World format 0.3: workspace homes, typed mounts/frames/limits, reserved placement volumes, camera-relative atmosphere, HDR bloom/exposure and static sky IBL.
- IPC 0.4: workspace bindings/focus, pull/place/return/recall, durable placement rules, data-object bindings, atmosphere and FOV. Older wire contracts stay frozen.
- Added independent ownership/interaction/limits and version-isolation tests.
Structural diff against 0.3: 17 entries added, 6 entries changed. Descriptions and $id changes are ignored.
23 changes
- added
method atmosphere.get - added
method atmosphere.set - added
method camera.fov - added
method data.object.bind - added
method placements.list - added
method placements.remove - added
method surface.place - added
method surface.pull - added
method surface.return - added
method surfaces.recall - added
method workspace.bind - added
method workspace.focus - added
method workspace.unfocus - added
mounts - added
notification mounts.changed - added
notification presentation.changed - added
presentation - changed
method session.hello- ~
result.protocol"0.3" (required) → "0.4" (required) - ~
result.methodsadds … (41 values))[]; removes … (28 values))[] - ~
result.eventsadds "data.updated", "mounts.changed", "presentation.changed")[]; removes "data.updated")[]
- ~
- changed
notification- ~
(definition):state.delta.notification | runtime.notice.notification | session.revoked.notification | location.transition.notification | ui.opened.notification | ui.closed.notification | data.updated.notification → :state.delta.notification | runtime.notice.notification | session.revoked.notification | location.transition.notification | ui.opened.notification | ui.closed.notification | data.updated.notification | mounts.changed.notification | presentation.changed.notification
- ~
- changed
notification state.delta- +
params.changes.mountsmounts - +
params.changes.presentationpresentation
- +
- changed
request- ~
(definition):session.hello.request | session.ping.request | state.subscribe.request | state.snapshot.request | state.unsubscribe.request | world.load.request | surface.focus.request | movement.set.request | shell.claim.request | shell.release.request | shell.overlay.request | runtime.exit.request | camera.get.request | camera.set.request | waypoint.set.request | waypoint.clear.request | route.set.request | route.clear.request | travel.start.request | travel.cancel.request | autodrive.start.request | autodrive.stop.request | ui.open.request | ui.close.request | data.publish.request | data.remove.request | shell.bind.request | workspace.activate.request → :session.hello.request | session.ping.request | state.subscribe.request | state.snapshot.request | state.unsubscribe.request | world.load.request | surface.focus.request | movement.set.request | shell.claim.request | shell.release.request | shell.overlay.request | runtime.exit.request | camera.get.request | camera.set.request | waypoint.set.request | waypoint.clear.request | route.set.request | route.clear.request | travel.start.request | travel.cancel.request | autodrive.start.request | autodrive.stop.request | ui.open.request | ui.close.request | data.publish.request | data.remove.request | shell.bind.request | workspace.activate.request | workspace.bind.request | workspace.focus.request | workspace.unfocus.request | surface.pull.request | surface.place.request | surface.return.request | placements.list.request | placements.remove.request | data.object.bind.request | atmosphere.get.request | atmosphere.set.request | camera.fov.request | surfaces.recall.request
- ~
- changed
response- ~
(definition):session.hello.response | session.ping.response | state.subscribe.response | state.snapshot.response | state.unsubscribe.response | world.load.response | surface.focus.response | movement.set.response | shell.release.response | shell.overlay.response | runtime.exit.response | shell.claim.response | camera.get.response | camera.set.response | waypoint.set.response | waypoint.clear.response | route.set.response | route.clear.response | travel.start.response | travel.cancel.response | autodrive.start.response | autodrive.stop.response | ui.open.response | ui.close.response | data.publish.response | data.remove.response | shell.bind.response | workspace.activate.response → :session.hello.response | session.ping.response | state.subscribe.response | state.snapshot.response | state.unsubscribe.response | world.load.response | surface.focus.response | movement.set.response | shell.release.response | shell.overlay.response | runtime.exit.response | shell.claim.response | camera.get.response | camera.set.response | waypoint.set.response | waypoint.clear.response | route.set.response | route.clear.response | travel.start.response | travel.cancel.response | autodrive.start.response | autodrive.stop.response | ui.open.response | ui.close.response | data.publish.response | data.remove.response | shell.bind.response | workspace.activate.response | workspace.bind.response | workspace.focus.response | workspace.unfocus.response | surface.pull.response | surface.place.response | surface.return.response | placements.list.response | placements.remove.response | data.object.bind.response | atmosphere.get.response | atmosphere.set.response | camera.fov.response | surfaces.recall.response
- ~
- changed
state- +
mountsmounts (required) - +
presentationpresentation (required)
- +
Methods
Each method is a JSON-RPC 2.0 request {jsonrpc, id, method, params} answered by {jsonrpc, id, result} or an error. Params and results are listed below.
session.hellosession.pingstate.subscribestate.snapshotstate.unsubscribeworld.loadsurface.focusmovement.setshell.claimshell.releaseshell.overlayruntime.exitcamera.getcamera.setwaypoint.setwaypoint.clearroute.setroute.cleartravel.starttravel.cancelautodrive.startautodrive.stopui.openui.closedata.publishdata.removeshell.bindworkspace.activateworkspace.bindworkspace.focusworkspace.unfocussurface.pullsurface.placesurface.returnplacements.listplacements.removedata.object.bindatmosphere.getatmosphere.setcamera.fovsurfaces.recall
session.hello#
params · object
| Field | Type | Constraints |
|---|---|---|
protocolsrequired | string[] | items ≥ 1 · unique items · each length 1–256 |
clientrequired | object | |
idrequired | id | |
namerequired | string | length 1–256 |
capabilitiesrequired | capability[] | items ≥ 0 · unique items |
token | string | length 64 · pattern ^[a-f0-9]{64}$ |
result · object
| Field | Type | Constraints |
|---|---|---|
protocolrequired | "0.4" | |
sessionIdrequired | string | length 1–128 |
capabilitiesrequired | capability[] | items ≥ 0 · unique items |
methodsrequired | ("session.hello" | "session.ping" | "state.subscribe" | "state.snapshot" | "state.unsubscribe" | "world.load" | "surface.focus" | "movement.set" | "shell.claim" | "shell.release" | "shell.overlay" | "runtime.exit" | "camera.get" | "camera.set" | … (41 values))[] | items ≥ 0 · unique items |
eventsrequired | ("state.delta" | "runtime.notice" | "session.revoked" | "location.transition" | "ui.opened" | "ui.closed" | "data.updated" | "mounts.changed" | "presentation.changed")[] | items ≥ 0 · unique items |
state.subscribe#
params · object
| Field | Type | Constraints |
|---|---|---|
topicsrequired | ["state"] |
result · object
| Field | Type | Constraints |
|---|---|---|
subscriptionIdrequired | string | length 1–128 |
snapshotrequired | snapshot |
state.snapshot#
params · object
| Field | Type | Constraints |
|---|---|---|
subscriptionIdrequired | string | length 1–128 |
result · object
| Field | Type | Constraints |
|---|---|---|
snapshotrequired | snapshot |
state.unsubscribe#
params · object
| Field | Type | Constraints |
|---|---|---|
subscriptionIdrequired | string | length 1–128 |
result · object
| Field | Type | Constraints |
|---|---|---|
okrequired | true |
surface.focus#
params · object
| Field | Type | Constraints |
|---|---|---|
surfaceIdrequired | string | length 1–128 |
intentrequired | "pointer" | "keyboard" |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | revision |
movement.set#
params · object
| Field | Type | Constraints |
|---|---|---|
modeIdrequired | id |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | revision |
shell.claim#
params · object
| Field | Type | Constraints |
|---|---|---|
outputsrequired | string[] | items ≥ 1 · unique items · each length 1–128 |
result · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
revisionrequired | revision |
shell.release#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | revision |
shell.overlay#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
outputIdrequired | string | length 1–128 |
visiblerequired | boolean | |
exclusiveInputrequired | boolean |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | revision |
camera.get#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
positionrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
orientationrequired | number[4] |
camera.set#
params · object
| Field | Type | Constraints |
|---|---|---|
positionrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
orientationrequired | number[4] |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
waypoint.set#
params · one of 2
| Field | Type | Constraints |
|---|---|---|
variant 1 | object | |
idrequired | string | length 1–128 |
labelrequired | string | length 1–256 |
targetrequired | target | |
variant 2 | object | |
idrequired | string | length 1–128 |
labelrequired | string | length 1–256 |
positionrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
waypoint.clear#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
route.set#
params · object
| Field | Type | Constraints |
|---|---|---|
pointsrequired | target[] | items 1–64 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
route.clear#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
travel.start#
params · object
| Field | Type | Constraints |
|---|---|---|
torequired | target | |
durationMs | integer | ≥ 0 · ≤ 10000 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
travel.cancel#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
autodrive.start#
params · object
| Field | Type | Constraints |
|---|---|---|
speed | number | ≥ 0.1 · ≤ 10 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
autodrive.stop#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ui.open#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
outputIdrequired | string | length 1–128 |
panelrequired | string | length 1–128 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ui.close#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
outputIdrequired | string | length 1–128 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
data.publish#
params · object
| Field | Type | Constraints |
|---|---|---|
sourceIdrequired | id | |
valuesrequired | map → number | boolean | string | entries ≤ 32 · keys: length ≤ 128 |
sequencerequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ttlMs | integer | ≥ 100 · ≤ 60000 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
data.remove#
params · object
| Field | Type | Constraints |
|---|---|---|
sourceIdrequired | id |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
shell.bind#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
pidrequired | integer | ≥ 1 · ≤ 2147483647 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
workspace.activate#
params · object
| Field | Type | Constraints |
|---|---|---|
idrequired | integer | ≥ 1 · ≤ 2147483647 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
workspace.bind#
params · object
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
workspace.focus#
params · object
| Field | Type | Constraints |
|---|---|---|
idrequired | integer | ≥ 1 · ≤ 2147483647 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
workspace.unfocus#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
surface.pull#
params · object
| Field | Type | Constraints |
|---|---|---|
surfaceIdrequired | string | length 1–256 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
surface.place#
params · object
| Field | Type | Constraints |
|---|---|---|
surfaceIdrequired | string | length 1–256 |
anchorId | slug |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
surface.return#
params · object
| Field | Type | Constraints |
|---|---|---|
surfaceIdrequired | string | length 1–256 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
placements.remove#
params · object
| Field | Type | Constraints |
|---|---|---|
worldIdrequired | id | |
areaIdrequired | slug | |
rulerequired | object | |
appClassrequired | string | length 1–256 |
titlerequired | string | length ≤ 256 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
data.object.bind#
params · object
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
atmosphere.get#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
profilerequired | null | atmosphere | |
qualityrequired | "high" | "intel" |
atmosphere.set#
params · object
| Field | Type | Constraints |
|---|---|---|
profilerequired | atmosphere |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
camera.fov#
params · object
| Field | Type | Constraints |
|---|---|---|
degreesrequired | number | ≥ 30 · ≤ 110 |
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
surfaces.recall#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
Notifications
state.deltaruntime.noticesession.revokedlocation.transitionui.openedui.closeddata.updatedmounts.changedpresentation.changed
state.delta#
params · object
| Field | Type | Constraints |
|---|---|---|
subscriptionIdrequired | string | length 1–128 |
sessionIdrequired | string | length 1–128 |
baseRevisionrequired | revision | |
revisionrequired | revision | |
changesrequired | object | entries ≥ 1 |
runtime | object | |
activerequired | boolean | |
outputsrequired | string[] | items ≥ 0 · unique items · each length 1–128 |
world | any of 2 | |
variant 1 | null | |
variant 2 | object | |
idrequired | id | |
spawnIdrequired | slug | |
surfaces | object[] | items ≥ 0 |
idrequired | string | length 1–128 |
kindrequired | "window" | "workspace" | "layer" | "web" | "custom" | |
titlerequired | string | length 0–512 |
logicalSizerequired | number[2] | each > 0 |
focusedrequired | boolean | |
movement | object | |
modeIdrequired | id | |
positionrequired | number[3] | |
orientationrequired | number[4] | |
shell | object | |
leasesrequired | object[] | items ≥ 0 |
idrequired | string | length 1–128 |
outputsrequired | string[] | items ≥ 1 · unique items · each length 1–128 |
overlaysrequired | object[] | items ≥ 0 |
outputIdrequired | string | length 1–128 |
visiblerequired | boolean | |
exclusiveInputrequired | boolean | |
location | location | |
integrations | integrations | |
spatial | spatial | |
workspaces | workspaces | |
mounts | mounts | |
presentation | presentation |
runtime.notice#
params · object
| Field | Type | Constraints |
|---|---|---|
levelrequired | "info" | "warning" | "error" | |
coderequired | string | length 1–256 |
messagerequired | string | length 1–4096 |
location.transition#
params · object
| Field | Type | Constraints |
|---|---|---|
phaserequired | "departing" | "travelling" | "arrived" | "cancelled" | "loading" | "failed" | |
progressrequired | null | number | |
torequired | destination | |
sessionIdrequired | string | length 1–128 |
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
idrequired | string | length 1–128 |
outputIdrequired | null | string | |
monotonicMsrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ui.opened#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
outputIdrequired | string | length 1–128 |
panelrequired | string | length 1–128 |
sessionIdrequired | string | length 1–128 |
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ui.closed#
params · object
| Field | Type | Constraints |
|---|---|---|
leaseIdrequired | string | length 1–128 |
outputIdrequired | string | length 1–128 |
sessionIdrequired | string | length 1–128 |
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
data.updated#
params · object
| Field | Type | Constraints |
|---|---|---|
sourceIdrequired | id | |
valuesrequired | map → number | boolean | string | entries ≤ 32 · keys: length ≤ 128 |
sequencerequired | integer | ≥ 0 · ≤ 2⁵³−1 |
monotonicMsrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ttlMsrequired | integer | ≥ 100 · ≤ 60000 |
sessionIdrequired | string | length 1–128 |
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
mounts.changed#
params · object
| Field | Type | Constraints |
|---|---|---|
sessionIdrequired | string | length 1–256 |
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
mountsrequired | mounts |
presentation.changed#
params · object
| Field | Type | Constraints |
|---|---|---|
sessionIdrequired | string | length 1–256 |
revisionrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
presentationrequired | presentation |
Types
statesnapshottargettransitionwaypointroutePointsourcelocationintegrationsdestinationmapmarkerspatialworkspacesmountspresentation
state#
object
| Field | Type | Constraints |
|---|---|---|
runtimerequired | object | |
activerequired | boolean | |
outputsrequired | string[] | items ≥ 0 · unique items · each length 1–128 |
worldrequired | any of 2 | |
variant 1 | null | |
variant 2 | object | |
idrequired | id | |
spawnIdrequired | slug | |
surfacesrequired | object[] | items ≥ 0 |
idrequired | string | length 1–128 |
kindrequired | "window" | "workspace" | "layer" | "web" | "custom" | |
titlerequired | string | length 0–512 |
logicalSizerequired | number[2] | each > 0 |
focusedrequired | boolean | |
movementrequired | object | |
modeIdrequired | id | |
positionrequired | number[3] | |
orientationrequired | number[4] | |
shellrequired | object | |
leasesrequired | object[] | items ≥ 0 |
idrequired | string | length 1–128 |
outputsrequired | string[] | items ≥ 1 · unique items · each length 1–128 |
overlaysrequired | object[] | items ≥ 0 |
outputIdrequired | string | length 1–128 |
visiblerequired | boolean | |
exclusiveInputrequired | boolean | |
locationrequired | location | |
integrationsrequired | integrations | |
spatialrequired | spatial | |
workspacesrequired | workspaces | |
mountsrequired | mounts | |
presentationrequired | presentation |
snapshot#
object
target#
one of 2
| Field | Type | Constraints |
|---|---|---|
variant 1 | object | |
positionrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
variant 2 | object | |
zoneIdrequired | string | length 1–128 |
transition#
object
| Field | Type | Constraints |
|---|---|---|
phaserequired | "departing" | "travelling" | "arrived" | "cancelled" | "loading" | "failed" | |
progressrequired | null | number | |
torequired | destination | |
idrequired | string | length 1–128 |
outputIdrequired | null | string | |
monotonicMsrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
waypoint#
object
| Field | Type | Constraints |
|---|---|---|
idrequired | string | length 1–128 |
labelrequired | string | length 1–256 |
targetrequired | target | |
positionrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
routePoint#
object
| Field | Type | Constraints |
|---|---|---|
targetrequired | target | |
positionrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
source#
object
| Field | Type | Constraints |
|---|---|---|
sourceIdrequired | id | |
valuesrequired | map → number | boolean | string | entries ≤ 32 · keys: length ≤ 128 |
sequencerequired | integer | ≥ 0 · ≤ 2⁵³−1 |
monotonicMsrequired | integer | ≥ 0 · ≤ 2⁵³−1 |
ttlMsrequired | integer | ≥ 100 · ≤ 60000 |
location#
object
| Field | Type | Constraints |
|---|---|---|
zonesrequired | World zones | |
waypointrequired | null | waypoint | |
routerequired | routePoint[] | items 0–64 |
autodriverequired | boolean | |
transitionrequired | null | transition |
map#
object
| Field | Type | Constraints |
|---|---|---|
svgrequired | string | length 1–65536 |
sha256required | string | pattern ^[a-f0-9]{64}$ |
boundsrequired | number[4] | |
worldToMaprequired | number[6] |
marker#
object
| Field | Type | Constraints |
|---|---|---|
idrequired | string | length 1–128 |
labelrequired | string | length ≤ 256 |
xrequired | number | ≥ 0 · ≤ 1 |
yrequired | number | ≥ 0 · ≤ 1 |
distancerequired | number | ≥ 0 |
occludedrequired | boolean |
spatial#
object
| Field | Type | Constraints |
|---|---|---|
worldrequired | any of 2 | |
variant 1 | null | |
variant 2 | object | |
idrequired | id | |
namerequired | string | length ≤ 256 |
placesrequired | object[] | items ≤ 64 |
idrequired | string | length 1–128 |
namerequired | string | length ≤ 256 |
positionrequired | number[3] | |
maprequired | null | map | |
outputrequired | any of 2 | |
variant 1 | null | |
variant 2 | object | |
idrequired | string | length 1–128 |
namerequired | string | length 1–128 |
widthrequired | integer | ≥ 1 |
heightrequired | integer | ≥ 1 |
scalerequired | number | > 0 |
projectionrequired | any of 2 | |
variant 1 | null | |
variant 2 | object | |
outputIdrequired | string | length 1–128 |
worldIdrequired | id | |
monotonicMsrequired | integer | ≥ 0 |
markersrequired | marker[] | items ≤ 64 |
workspaces#
object
mounts#
object
| Field | Type | Constraints |
|---|---|---|
areasrequired | area[] | items ≤ 32 |
anchorsrequired | object[] | items ≤ 128 |
idrequired | slug | |
poserequired | pose | |
sizerequired | size2 | |
mountrequired | mount | |
areaIdrequired | slug | |
bindingsrequired | object[] | items ≤ 32 |
idrequired | integer | ≥ 1 · ≤ 2147483647 |
worldIdrequired | id | |
areaIdrequired | slug | |
placementsrequired | object[] | items ≤ 128 |
worldIdrequired | id | |
areaIdrequired | slug | |
anchorIdrequired | slug | |
rulerequired | object | |
appClassrequired | string | length 1–256 |
titlerequired | string | length ≤ 256 |
objectsrequired | object[] | items ≤ 128 |
idrequired | slug | |
areaIdrequired | slug | |
poserequired | pose | |
mountTyperequired | "facade-wall" | "hanging-wall" | "wall-inset-console" | "banner" | "lectern" | "operator-desk" | "field-rig" | "kiosk-pillar" | "globe" | "crate" | "blast-door-screen" | "terminal-bench" | "radar-dish" | |
sourceIdrequired | null | id | |
carriedSurfaceIdrequired | null | string | |
desktopWorkspaceIdrequired | null | integer | |
placementZonesrequired | placementZone[] | items ≤ 32 |
instancesrequired | object[] | items ≤ 16 |
surfaceIdrequired | string | length 1–128 |
workspaceIdrequired | integer | ≥ 1 |
areaIdrequired | slug | |
anchorIdrequired | string | length ≤ 128 |
statusrequired | "carried" | "placed" | "recalled" |
presentation#
object
| Field | Type | Constraints |
|---|---|---|
profilerequired | null | atmosphere | |
fovrequired | number | ≥ 30 · ≤ 110 |
qualityrequired | "high" | "intel" |
Frame envelopes
error#
object
| Field | Type | Constraints |
|---|---|---|
jsonrpcrequired | "2.0" | |
idrequired | string | null | |
errorrequired | object | |
coderequired | -32700 | -32600 | -32601 | -32602 | -32603 | -32008 | -32007 | -32006 | -32005 | -32004 | -32003 | -32002 | -32001 | |
messagerequired | string | length 1–4096 |
data | object | |
retryablerequired | boolean |
request#
session.hello.request | session.ping.request | state.subscribe.request | state.snapshot.request | state.unsubscribe.request | world.load.request | surface.focus.request | movement.set.request | shell.claim.request | shell.release.request | shell.overlay.request | runtime.exit.request | camera.get.request | camera.set.request | waypoint.set.request | waypoint.clear.request | route.set.request | route.clear.request | travel.start.request | travel.cancel.request | autodrive.start.request | autodrive.stop.request | ui.open.request | ui.close.request | data.publish.request | data.remove.request | shell.bind.request | workspace.activate.request | workspace.bind.request | workspace.focus.request | workspace.unfocus.request | surface.pull.request | surface.place.request | surface.return.request | placements.list.request | placements.remove.request | data.object.bind.request | atmosphere.get.request | atmosphere.set.request | camera.fov.request | surfaces.recall.request
response#
session.hello.response | session.ping.response | state.subscribe.response | state.snapshot.response | state.unsubscribe.response | world.load.response | surface.focus.response | movement.set.response | shell.release.response | shell.overlay.response | runtime.exit.response | shell.claim.response | camera.get.response | camera.set.response | waypoint.set.response | waypoint.clear.response | route.set.response | route.clear.response | travel.start.response | travel.cancel.response | autodrive.start.response | autodrive.stop.response | ui.open.response | ui.close.response | data.publish.response | data.remove.response | shell.bind.response | workspace.activate.response | workspace.bind.response | workspace.focus.response | workspace.unfocus.response | surface.pull.response | surface.place.response | surface.return.response | placements.list.response | placements.remove.response | data.object.bind.response | atmosphere.get.response | atmosphere.set.response | camera.fov.response | surfaces.recall.response
Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 d624f3a41d020f89f5963b84abcb83acfffbda0c7ed32613c498f89b541dc7b8.