@hyprune/schema 0.0.0-stage → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,144 @@
+# Changelog
+
+
+## v0 / 0.1.0 — 2026-10-07 (proposed)
+
+Initial JSON Schema 2020-12 family: world format `0.1`, IPC `0.1`, extension manifest/API `0.1`, screen descriptor `0.1`. Includes every core method's request and result plus notifications, offline examples and a Node validator. Identifiers are reserved for these contracts; incompatible changes require a new wire/format identifier and migration notes. No runtime compatibility is claimed yet.
+
+## 0.2.0 — 2026-10-07
+
+Adds frozen `v0.2/` schemas for IPC 0.2 and world format 0.2; `v0/` stays unchanged. The validator accepts an optional fourth `version` argument (default `0.1`); CLI accepts `[response-method|-] [contract-version]`.
+
+IPC adds camera get/set, waypoint/route, travel, autodrive, ui.open/close, data.publish/remove and presentation notifications. `location` and `integrations` are revisioned state keys. Publishing requires its own capability; scalar values, TTL, sequence and ownership are specified by RFC-0003. World 0.2 has the same manifest shape, with RFC-0004's sampler/transform/PBR material semantics. No mock-only protocol is accepted.
+
+M1 shell reconciliation adds stable transition IDs, output identity, monotonic timestamps and indeterminate loading/failed phases. World-load destinations remain distinct from point/zone navigation targets.
+
+## 0.3.0 — first real session
+
+Frozen IPC 0.3 adds verified shell Wayland-child binding, workspace activation,
+revisioned safe inline map/metadata, selected-output descriptor and core-projected
+markers. 0.1/0.2 and world formats remain frozen. New positive/negative tests cover
+version isolation, reserved parameters, PID/workspace bounds and marker clipping.
+
+## 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.
+
+## 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.
+
+IPC 0.6 (M3B): independent input keymap v2, three variants per action, core-owned validated persistence and lease-bound capture; closed keymap/editor state, per-area paths and object transforms, scope FOV down to 3 degrees, Map opening intent. Older contracts remain byte-identical.
+
+IPC 0.7 publishes the exact shell graphics handoff: discoverable presets/effects,
+validated sparse `graphics.set`, effective settings and asynchronous GPU timings.
+IPC 0.8 adds `keymap.holds` (monotonic start time and configured duration) for
+shell-owned hold animation. Protocols through 0.7 retain their exact shapes;
+world format remains 0.3. No compositor config reload is involved.
+
+## Climbing: world 0.4 and IPC 0.11
+
+World 0.4 adds validated oriented climbable segments, climb-face normals,
+feet-position exits, material type and optional speed. Runtime validates capsule
+clearance against world collision. IPC 0.11 adds version-isolated movement
+activity, ladder identity and interaction prompt fields. Previous versions stay
+unchanged. See `test/climbing.test.mjs` and RFC-0004/0006.
+
+## IPC 0.12 — deterministic input and camera recordings
+
+Extends frozen IPC 0.11 (climbing) with input.control-gated recording.start/stop/
+mark/status and replay.start/stop/status, bounded assertion specs, and the
+unbound record.toggle action in every input mode. Older keymaps are projected
+without that action. Runtime records are private, versioned JSONL, with app
+keystrokes masked by default. Replay uses a fixed 60 Hz clock; camera-only
+replay never forwards input. Existing 0.11 movement activity remains inherited.
+
+## IPC 0.13 and world 0.5 — generic authoring and rendering controls
+
+- Capability-gated photo-camera hold with normalized quaternion, 5–140° vertical
+  FOV, NDC lens shift and fixed render scale; camera.get reports actual lens state.
+- Optional authored depth/normal ink style and Performance override/cost.
+- Explicit visibility areas with bounds, scene-node subtrees and visibleFrom
+  lists. Unassigned geometry and cameras outside areas remain visible.
+- Prior world and IPC schemas are unchanged; positive/negative tests cover the
+  new bounds, links, ownership and closed fields.
+
+## IPC 0.15 — tool slots, pocket queue and content sizing
+
+Adds generic tool declarations, bounded pocket/client feedback, canonical shared
+Primary/Secondary/Alternate/Cycle bindings and optional persistent placement
+content dimensions. Earlier IPC schemas stay byte-for-byte frozen. World format
+is unchanged (0.5).
+
+## World 0.7 — 2026-10-09
+
+`v0.7/world.schema.json` (world.json shape as 0.6, `formatVersion: "0.7"`) and
+`v0.7/common.schema.json` (0.6 definitions). New `scene` validation kind checks a
+package's `scene.gltf` against its world format: 0.7 may require
+`KHR_texture_basisu` (KTX2 material textures), `EXT_meshopt_compression` and
+`KHR_mesh_quantization`, and must list those it uses in `extensionsRequired`;
+lightmap textures stay PNG in every v0 format. Exports `atLeast()`,
+`worldFormats` and `sceneExtensions()` so version gates are not hard-coded lists.
+Inheritance test: every valid 0.6 document is valid as 0.7. IPC is unchanged.
+
+## IPC 0.16 — 2026-10-10
+
+`v0.16/ipc.schema.json`: graphics `upscaler` setting (`fsr1` | `bilinear` |
+null) in config, effective values, overrides, presets and `graphics.set`
+patches; `session.hello` reports `0.16`. Inheritance test: every 0.15
+definition exists in 0.16 and the graphics properties differ only by the new key.
+
+## IPC 0.17: debug capture notes
+
+- `capture.annotate {captureId, note}` (shell.control): writes an optional note
+  (0..1000 code points, no control characters) into a debug capture's JSON and
+  the captures index. Result `{revision}`.
+- `capture.taken {captureId, timestampMs, mode}` notification, sent to 0.17
+  shells when U (or the mode's capture binding) snapshots the world, before the
+  files are written.
+- Everything else is inherited from 0.16 unchanged.
+
+## IPC 0.18: device-scaled offload power cap and offload device selection
+
+- `offload_power_cap_w` in `graphicsConfig`/`graphicsPatch` is a number 20–1000
+  or `null` (was 20–100). `null`, the new default, is automatic: the battery
+  profile ceiling with a battery, otherwise 75 % of the offload GPU's enforced
+  power limit (80 W when the limit is unknown).
+- New `offload_device`: `"auto"` (default) or the lowercase PCI address
+  (`domain:bus:device.function`, e.g. `0000:65:00.0`) of the GPU that runs the
+  offload renderer.
+- `performance` (graphics.get/set) gains required `capSource` (`profile` |
+  `device` | `configured` | `fallback`) and `device` (`null` or `{pci, node,
+  name, enforcedLimitW, selection, drivesCompositor}`). `profile` is unchanged;
+  systems without a battery report `full-ac`.
+- `session.hello` reports `0.18`. Everything else is inherited from 0.17
+  unchanged. Inheritance test: every 0.17 definition is identical except the
+  graphics properties (only the two offload keys differ), `performance` (only
+  the two new keys) and the hello protocol constant.
+
+## IPC 0.19: player settings, view bob and reticle
+
+- `player.get {}` (state.read) and `player.set {patch}` (movement.control) return
+  `playerSettings {config, defaults, overrides, options, ranges, path, error}`.
+  `playerConfig` keys: `walk_speed`, `run_speed`, `view_bob`
+  (`off|subtle|normal`), `reticle_style`, `reticle_size`, `reticle_thickness`,
+  `reticle_gap`, `reticle_opacity`, `reticle_outline`, `reticle_colour`
+  (`"theme"` or RGB), `reticle_dynamic`, `reach_grab`, `reach_mount`,
+  `reach_placement`. `playerPatch` takes any subset (at least one key); `null`
+  removes a persisted override. `overrides` uses `playerOverrides` (the same
+  keys, never null, may be empty).
+- `graphics` `fov` accepts 30..120 (was 30..110) in config and patches.
+- `overlayStyle` gains `reticleColor`, `validColor` and `invalidColor` (RGB
+  0..1; required in the result, optional in the params patch).
+- `interaction.reticle {state, action}` (required): what the reticle shows
+  (`hidden|neutral|typing|target|valid|out_of_range|invalid|holding`) and the
+  action it would take (`""|click|grab|pocket|place|mount|select|path|drop`).
+- Everything else is inherited from 0.18 unchanged, including the offload cap
+  and device keys; `session.hello` reports `0.19`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hyprune contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,141 @@
-# Temporary Holding Version
+# Hyprune schemas · v0
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Hyprune** is an explorable, world-driven desktop environment for Hyprland: your workspaces become places you can walk through, with live windows on the walls. This repository holds the versioned **schemas** for world packages, IPC and manifests, and their validator. Install Hyprune through the [hyprune](https://github.com/hyprune/hyprune) repository (starter kits, Nix, Arch); learn more at [hyprune.com](https://hyprune.com). Licence: MIT.
+
+Versioned contracts for Hyprune, a world-driven Hyprland desktop: world packages (formats 0.1–0.7), the IPC protocol (0.1–0.19), extension and screen-type manifests and the input keymap. JSON Schema dialect: **2020-12**. Every version is frozen once published; core, the shell and the SDK pin these exact files. Readable reference: [hyprune.com/reference/schema](https://hyprune.com/reference/schema/).
+
+## Install
+
+```sh
+npm i -D @hyprune/schema
+npx hyprune-validate world world.json - 0.7             # a world package manifest
+npx hyprune-validate scene scene.gltf - 0.7 world.json   # its glTF against the world format
+```
+
+```js
+import { validate, worldFormats } from '@hyprune/schema';
+import schema from '@hyprune/schema/v0.7/world.schema.json' with { type: 'json' };
+
+const result = validate('world', manifest, undefined, worldFormats.at(-1));
+if (!result.valid) console.error(result.errors.join('\n'));
+```
+
+Every schema file is importable at `@hyprune/schema/v0.N/<name>.schema.json` (`v0/` holds the 0.1 contracts). For a full world authoring workflow (validate, pack, scaffold) use [`@hyprune/sdk`](https://github.com/hyprune/sdk).
+
+| Schema | Contract |
+| --- | --- |
+| `v0/world.schema.json` | Data-only manifest, glTF entry, spawns, anchors, zones, navigation, collision, audio, lightmaps and provenance. |
+| `v0/ipc.schema.json` | JSON-RPC request/response/error envelope, all 12 core methods with typed params/results, 3 notifications and state. |
+| `v0/extension.schema.json` | Process entrypoint, contributions, requested grants and mandatory sandbox profile. |
+| `v0/screen-type.schema.json` | Source kind, planar geometry, resolution, color/alpha, refresh ceiling and input support. |
+| `v0/common.schema.json` | Shared IDs, versions, paths, poses, revisions and capabilities. |
+
+[RFC source](https://github.com/hyprune/docs/tree/main/src/content/docs/rfcs) is normative for semantics. [RFC-0003](https://hyprune.com/rfcs/0003-ipc/) defines IPC; [RFC-0004](https://hyprune.com/rfcs/0004-world-format/) defines worlds. The `$id` URLs are mirrored by docs for authoring; this validator registers all schemas locally and never fetches them.
+
+## Validate
+
+Use Node >=22.12 (CI pins 24.14.0), npm, and the committed lockfile:
+
+```sh
+npm ci
+npm test
+npm run validate -- world examples/world.json
+npm run validate -- extension examples/extension.json
+npm run validate -- screen-type examples/screen-type.json
+npm run validate -- ipc examples/ipc/state.delta.notification.json
+npm run validate -- ipc examples/ipc/session.ping.response.json session.ping
+cat examples/world.json | npm run validate -- world -
+```
+
+Exit 0 = valid, 1 = contract violation, 2 = usage/read/parse failure. The CLI accepts one JSON document up to 1 MiB. Optional method context validates a response against the outstanding request's method, since JSON-RPC responses do not repeat method names. Error responses should be validated as envelopes without a success-method context. Clients must also correlate the response ID themselves.
+
+**Why Node:** the docs toolchain already needs it, Ajv supports draft 2020-12 with strict compilation, and JavaScript matches the reference shell/SDK direction. The CLI adds no global install and uses pinned Ajv and SPDX parser dependencies. Python would add a second tool environment here.
+
+## Scope and limits
+
+Schemas reject unknown fields outside explicit extension maps. The validator adds manifest-local semantic checks: duplicate IDs/material bindings, default spawn references, normalized quaternions, AABB ordering, SPDX expressions, required extension presence, contribution namespaces, advancing deltas and overlay/lease invariants.
+
+This is not a runtime transport parser or package installer. It does not check duplicate JSON keys (JSON.parse retains the last), transport framing/depth/session ordering, live grants, asset existence/rights, attribution coverage, glTF indices/UV1, symlinks, archives, codecs, collision or spawn clearance. RFC-0002/0003/0004 require those checks in core and the future SDK. Do not use a passing manifest as proof a package is safe to execute or load.
+
+`examples/world.json` is an original synthetic manifest exercising metadata; referenced scene/audio files are intentionally not supplied. It is not a playable package. IPC fixtures cover every request, success result, notification and an error; they are independent shape examples, not a chronological authenticated session. Tokens are omitted, so hello demonstrates negotiation shape, not privileged authentication.
+
+## Evolving contracts
+
+Update RFC + schema + positive/negative tests + [CHANGELOG.md](CHANGELOG.md) together. Consumers pin a schema commit/release. New structural or semantic contracts get a new protocol/format identifier; never quietly redefine a released one. docs mirrors these exact files with a recorded source commit and checksums. M0/WIP commits are deliberately available before implementation.
+
+MIT; see [LICENSE](LICENSE).
+
+M1 contracts are frozen separately under `v0.2/`. Select them explicitly:
+
+```js
+validate('ipc', frame, responseMethod, '0.2');
+validate('world', manifest, undefined, '0.2');
+```
+
+CLI: `npm run validate -- world world.json - 0.2`. Existing default calls continue validating 0.1. Wire protocol and package format versions are independent.
+
+First-session IPC `0.3` lives in `v0.3/{common,ipc}.schema.json` and is selected with
+`validate('ipc', frame, method, '0.3')`. It adds verified shell-child binding,
+workspace locations and bounded map/projection/output descriptors. World format
+selection remains 0.1/0.2; optional Map metadata is documented in RFC-0004/0008.
+
+## M3A contract
+
+`v0.5/ipc.schema.json` adds hands-on interaction and workspace app state, plus
+custom pose placements. Select version `0.5` explicitly; earlier contracts and
+world format 0.3 remain frozen. App icons are theme names, not arbitrary URLs.
+
+IPC **0.12** adds recording/replay control and `record.toggle`; 0.11 remains the
+climbing contract. Both inherit the 0.10 Performance API. Record/replay mutations
+require `input.control`; ordinary observers cannot start capture or replay.
+
+IPC **0.13** adds dev-only `camera.author` grants (`camera.photo`/`camera.release`),
+actual camera roll/FOV/lens shift, and Performance controls for ink and visibility.
+World **0.5** adds optional `atmosphere.outline` and directed visibility regions.
+Older schemas remain frozen. Photo grants are not part of a normal shell grant.
+
+IPC **0.14** adds nullable `graphics.outline_quality` (`fast` or `smooth`).
+Fast keeps a one-logical-pixel stroke; smooth honours the world's 1–4 px width.
+Low/Medium inherit fast, High/Ultra smooth. This is a graphics-only revision;
+world format remains 0.5 and previous IPC schemas remain frozen.
+
+0.14 also adds nullable `outline_width_px` (1–4) and `outline_colour` (three
+0–1 display RGB values). These are persistent user graphics overrides; null means
+use the current world's authored style. The revision-response envelope uses
+`anyOf` so shared `{revision:...}` responses are unambiguous; per-method validation
+still supplies the result type.
+
+World format **0.6** adds optional `playable` eye-position volumes (boxes or convex
+hulls), per-area regions and maximum fly height, plus explicit `backdrop.farCards`
+node declarations. IPC remains 0.15; authoring geometry is not added to IPC area
+records. See RFC-0004 for composition, limits and motion semantics.
+
+World format **0.7** keeps the 0.6 world.json shape and allows compressed and
+optimised scene assets: `KHR_texture_basisu` (KTX2, material textures only),
+`EXT_meshopt_compression` and `KHR_mesh_quantization`. Lightmaps stay PNG.
+`validate('scene', gltf, undefined, worldFormat, {world})` (CLI:
+`npm run validate -- scene scene.gltf - 0.7 world.json`) checks
+`extensionsRequired` and lightmap textures against the world format. Version
+gates use `atLeast()`; see RFC-0004 "world 0.7".
+
+IPC **0.16** adds the `upscaler` graphics key (`"fsr1"`, `"bilinear"` or `null` to
+inherit the preset) to `graphicsConfig`/`graphicsPatch`. Every 0.15 definition is
+otherwise unchanged; earlier schemas stay frozen. See RFC-0003/0008 amendments.
+
+IPC **0.17** adds debug capture notes: the `capture.taken` notification (capture ID,
+time and input mode, sent to shells) and `capture.annotate {captureId, note}`
+(shell.control; 0-1000 code points, no control characters). Every 0.16 definition
+is unchanged. See the RFC-0008 amendment "IPC 0.17 capture notes".
+
+IPC **0.18** scales the offload power cap to the device: `offload_power_cap_w`
+accepts 20-1000 W or `null` (automatic, the new default), and the new
+`offload_device` key is `"auto"` or a lowercase PCI address. `performance` reports
+where its cap comes from (`capSource`) and the chosen GPU (`device`, or `null`).
+Every 0.17 definition is otherwise unchanged. See the RFC-0009 amendment
+"IPC 0.18 device-scaled offload power and device selection".
+
+IPC **0.19** adds player settings (`player.get`/`player.set`: walk/run speed, view
+bob, reticle style/size/colour and reach limits), widens graphics `fov` to 30-120,
+adds `reticleColor`/`validColor`/`invalidColor` to the overlay style and the
+required `interaction.reticle {state, action}`. Every other 0.18 definition is
+unchanged. See the RFC-0006 amendment "IPC 0.19 player settings and reticle".

package/bin/validate.mjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { validate } from '../lib/validate.mjs';
+const [kind, file, method, version, worldFile, ...extra] = process.argv.slice(2);
+if (!kind || !file || extra.length || (worldFile && kind !== 'scene')) {
+  console.error('Usage: hyprune-validate <world|extension|screen-type|ipc> <file.json|-> [response-method|-] [contract-version]\n' +
+                '       hyprune-validate scene <scene.gltf> - <world-format> <world.json>\n(in this repository: npm run validate -- ...)');
+  process.exitCode = 2;
+} else {
+  try {
+    const bytes = readFileSync(file === '-' ? 0 : file);
+    if (bytes.length > 1_048_576) throw new Error('Document exceeds 1 MiB');
+    const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
+    const world = worldFile ? JSON.parse(readFileSync(worldFile, 'utf8')) : undefined;
+    const result = validate(kind, value, method === '-' ? undefined : method, version, { world });
+    if (result.valid) console.log(`VALID ${kind}: ${file}`);
+    else { console.error(result.errors.join('\n')); process.exitCode = 1; }
+  } catch (error) { console.error(error.message); process.exitCode = 2; }
+}

package/examples/extension.json

@@ -0,0 +1,22 @@
+{
+  "manifestVersion": "0.1",
+  "id": "com.hyprune.clock",
+  "version": "0.1.0",
+  "name": "World clock",
+  "license": "MIT",
+  "apiVersion": "0.1",
+  "runtime": "process",
+  "entrypoint": "bin/clock",
+  "capabilities": [
+    "state.read"
+  ],
+  "contributes": {
+    "widgets": [
+      "com.hyprune.clock.widget"
+    ]
+  },
+  "sandbox": {
+    "required": true,
+    "network": false
+  }
+}

package/examples/ipc/error.json

@@ -0,0 +1,11 @@
+{
+  "jsonrpc": "2.0",
+  "id": "1",
+  "error": {
+    "code": -32002,
+    "message": "Capability denied.",
+    "data": {
+      "retryable": false
+    }
+  }
+}

package/examples/ipc/movement.set.request.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "id": "8",
+  "method": "movement.set",
+  "params": {
+    "modeId": "com.hyprune.fly"
+  }
+}

package/examples/ipc/movement.set.response.json

@@ -0,0 +1,7 @@
+{
+  "jsonrpc": "2.0",
+  "id": "8",
+  "result": {
+    "revision": 1
+  }
+}

package/examples/ipc/runtime.exit.request.json

@@ -0,0 +1,6 @@
+{
+  "jsonrpc": "2.0",
+  "id": "12",
+  "method": "runtime.exit",
+  "params": {}
+}

package/examples/ipc/runtime.exit.response.json

@@ -0,0 +1,7 @@
+{
+  "jsonrpc": "2.0",
+  "id": "12",
+  "result": {
+    "revision": 1
+  }
+}

package/examples/ipc/runtime.notice.notification.json

@@ -0,0 +1,9 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.notice",
+  "params": {
+    "level": "info",
+    "code": "world.ready",
+    "message": "World ready."
+  }
+}

package/examples/ipc/session.hello.request.json

@@ -0,0 +1,17 @@
+{
+  "jsonrpc": "2.0",
+  "id": "1",
+  "method": "session.hello",
+  "params": {
+    "protocols": [
+      "0.1"
+    ],
+    "client": {
+      "id": "com.hyprune.shell",
+      "name": "Hyprune shell"
+    },
+    "capabilities": [
+      "state.read"
+    ]
+  }
+}

package/examples/ipc/session.hello.response.json

@@ -0,0 +1,23 @@
+{
+  "jsonrpc": "2.0",
+  "id": "1",
+  "result": {
+    "protocol": "0.1",
+    "sessionId": "session-1",
+    "capabilities": [
+      "state.read"
+    ],
+    "methods": [
+      "session.hello",
+      "session.ping",
+      "state.subscribe",
+      "state.snapshot",
+      "state.unsubscribe"
+    ],
+    "events": [
+      "state.delta",
+      "runtime.notice",
+      "session.revoked"
+    ]
+  }
+}

package/examples/ipc/session.ping.request.json

@@ -0,0 +1,6 @@
+{
+  "jsonrpc": "2.0",
+  "id": "2",
+  "method": "session.ping",
+  "params": {}
+}

package/examples/ipc/session.ping.response.json

@@ -0,0 +1,7 @@
+{
+  "jsonrpc": "2.0",
+  "id": "2",
+  "result": {
+    "monotonicMs": 1000
+  }
+}

package/examples/ipc/session.revoked.notification.json

@@ -0,0 +1,7 @@
+{
+  "jsonrpc": "2.0",
+  "method": "session.revoked",
+  "params": {
+    "reason": "Grant revoked."
+  }
+}

package/examples/ipc/shell.claim.request.json

@@ -0,0 +1,10 @@
+{
+  "jsonrpc": "2.0",
+  "id": "9",
+  "method": "shell.claim",
+  "params": {
+    "outputs": [
+      "output-1"
+    ]
+  }
+}

package/examples/ipc/shell.claim.response.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "id": "9",
+  "result": {
+    "leaseId": "lease-1",
+    "revision": 1
+  }
+}

package/examples/ipc/shell.overlay.request.json

@@ -0,0 +1,11 @@
+{
+  "jsonrpc": "2.0",
+  "id": "11",
+  "method": "shell.overlay",
+  "params": {
+    "leaseId": "lease-1",
+    "outputId": "output-1",
+    "visible": true,
+    "exclusiveInput": true
+  }
+}

package/examples/ipc/shell.overlay.response.json

@@ -0,0 +1,7 @@
+{
+  "jsonrpc": "2.0",
+  "id": "11",
+  "result": {
+    "revision": 1
+  }
+}

package/examples/ipc/shell.release.request.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "id": "10",
+  "method": "shell.release",
+  "params": {
+    "leaseId": "lease-1"
+  }
+}

package/examples/ipc/shell.release.response.json

@@ -0,0 +1,7 @@
+{
+  "jsonrpc": "2.0",
+  "id": "10",
+  "result": {
+    "revision": 1
+  }
+}

package/examples/ipc/state.delta.notification.json

@@ -0,0 +1,18 @@
+{
+  "jsonrpc": "2.0",
+  "method": "state.delta",
+  "params": {
+    "subscriptionId": "sub-1",
+    "sessionId": "session-1",
+    "baseRevision": 0,
+    "revision": 1,
+    "changes": {
+      "runtime": {
+        "active": true,
+        "outputs": [
+          "output-1"
+        ]
+      }
+    }
+  }
+}

package/examples/ipc/state.snapshot.request.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "id": "4",
+  "method": "state.snapshot",
+  "params": {
+    "subscriptionId": "sub-1"
+  }
+}

package/examples/ipc/state.snapshot.response.json

@@ -0,0 +1,37 @@
+{
+  "jsonrpc": "2.0",
+  "id": "4",
+  "result": {
+    "snapshot": {
+      "sessionId": "session-1",
+      "revision": 0,
+      "state": {
+        "runtime": {
+          "active": false,
+          "outputs": [
+            "output-1"
+          ]
+        },
+        "world": null,
+        "surfaces": [],
+        "movement": {
+          "modeId": "com.hyprune.fly",
+          "position": [
+            0,
+            1,
+            0
+          ],
+          "orientation": [
+            0,
+            0,
+            0,
+            1
+          ]
+        },
+        "shell": {
+          "leases": []
+        }
+      }
+    }
+  }
+}

package/examples/ipc/state.subscribe.request.json

@@ -0,0 +1,10 @@
+{
+  "jsonrpc": "2.0",
+  "id": "3",
+  "method": "state.subscribe",
+  "params": {
+    "topics": [
+      "state"
+    ]
+  }
+}