IPC protocol 0.5
Schema reference / IPC protocol / 0.5
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.4
Changelog · 0.5.0 (M3A)
Frozen IPC 0.5 adds revisioned interaction mode/tool state, workspace app metadata, and custom surface pose/size placement rules. All prior schemas stay unchanged; world format remains 0.3. Tests cover exact version isolation, closed objects, bounded app/tool collections and complete custom placement records.
Structural diff against 0.4: 2 entries added, 5 entries changed. Descriptions and $id changes are ignored.
7 changes
- added
apps - added
interaction - changed
method placements.list- ~
result.placementsobject[] (required) · items ≤ 128 → any of 2[] (required) · items ≤ 128 - +
result.placements[]|1object - +
result.placements[]|1.worldIdid (required) - +
result.placements[]|1.areaIdslug (required) - +
result.placements[]|1.anchorIdslug (required) - +
result.placements[]|1.ruleobject (required) - +
result.placements[]|1.rule.appClassstring (required) · length 1–256 - +
result.placements[]|1.rule.titlestring (required) · length ≤ 256 - +
result.placements[]|object - +
result.placements[]|.worldIdid (required) - +
result.placements[]|.areaIdslug (required) - +
result.placements[]|.anchorId"" (required) - +
result.placements[]|.ruleobject (required) - +
result.placements[]|.rule.appClassstring (required) · length 1–256 - +
result.placements[]|.rule.titlestring (required) · length ≤ 256 - +
result.placements[]|.posepose (required) - +
result.placements[]|.sizesize2 (required) - −
result.placements[].worldId - −
result.placements[].areaId - −
result.placements[].anchorId - −
result.placements[].rule - −
result.placements[].rule.appClass - −
result.placements[].rule.title
- ~
- changed
method session.hello- ~
result.protocol"0.4" (required) → "0.5" (required)
- ~
- changed
mounts- ~
placementsobject[] (required) · items ≤ 128 → any of 2[] (required) · items ≤ 128 - +
placements[]|1object - +
placements[]|1.worldIdid (required) - +
placements[]|1.areaIdslug (required) - +
placements[]|1.anchorIdslug (required) - +
placements[]|1.ruleobject (required) - +
placements[]|1.rule.appClassstring (required) · length 1–256 - +
placements[]|1.rule.titlestring (required) · length ≤ 256 - +
placements[]|object - +
placements[]|.worldIdid (required) - +
placements[]|.areaIdslug (required) - +
placements[]|.anchorId"" (required) - +
placements[]|.ruleobject (required) - +
placements[]|.rule.appClassstring (required) · length 1–256 - +
placements[]|.rule.titlestring (required) · length ≤ 256 - +
placements[]|.posepose (required) - +
placements[]|.sizesize2 (required) - −
placements[].worldId - −
placements[].areaId - −
placements[].anchorId - −
placements[].rule - −
placements[].rule.appClass - −
placements[].rule.title
- ~
- changed
notification state.delta- +
params.changes.appsapps - +
params.changes.interactioninteraction
- +
- changed
state- +
interactioninteraction (required) - +
appsapps (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.5" | |
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.list#
params · {} (no fields)
result · object
| Field | Type | Constraints |
|---|---|---|
placementsrequired | any of 2[] | items ≤ 128 |
variant 1 | object | |
worldIdrequired | id | |
areaIdrequired | slug | |
anchorIdrequired | slug | |
rulerequired | object | |
appClassrequired | string | length 1–256 |
titlerequired | string | length ≤ 256 |
when anchorId = "" | object | |
worldIdrequired | id | |
areaIdrequired | slug | |
anchorIdrequired | "" | |
rulerequired | object | |
appClassrequired | string | length 1–256 |
titlerequired | string | length ≤ 256 |
poserequired | pose | |
sizerequired | size2 |
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 | |
apps | apps | |
interaction | interaction |
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
statesnapshottargettransitionwaypointroutePointsourcelocationintegrationsdestinationmapmarkerspatialworkspacesmountspresentationinteractionapps
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 | |
interactionrequired | interaction | |
appsrequired | apps |
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 | any of 2[] | items ≤ 128 |
variant 1 | object | |
worldIdrequired | id | |
areaIdrequired | slug | |
anchorIdrequired | slug | |
rulerequired | object | |
appClassrequired | string | length 1–256 |
titlerequired | string | length ≤ 256 |
when anchorId = "" | object | |
worldIdrequired | id | |
areaIdrequired | slug | |
anchorIdrequired | "" | |
rulerequired | object | |
appClassrequired | string | length 1–256 |
titlerequired | string | length ≤ 256 |
poserequired | pose | |
sizerequired | size2 | |
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" |
interaction#
object
| Field | Type | Constraints |
|---|---|---|
moderequired | "movement" | "typing" | "workspace" | "fullscreen" | |
toolrequired | integer | ≥ 1 · ≤ 5 |
toolsrequired | ("pointer" | "mount" | "path")[5] | |
nocliprequired | boolean | |
cursorrequired | "desktop" | "workspace" | "fullscreen" | "director" | "virtual" | "reticle" | |
taggedSurfaceIdrequired | null | string |
apps#
object[] · items ≤ 16
| Field | Type | Constraints |
|---|---|---|
surfaceIdrequired | string | length 1–128 |
workspaceIdrequired | integer | ≥ 0 |
titlerequired | string | length ≤ 512 |
appClassrequired | string | length ≤ 256 |
iconrequired | string | length ≤ 256 |
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 2744c0c8a8f416ec33a1dd3d688a5bbe3bd7fc6193c17860334b317d181fe3b9.