Reality Relay
Request access

Reality Relay Developers

Build presence
into anything.

One typed model for composing a Scene, fitting it to a Space and operating the live Session.

Read the quickstart Request SDK access
Release
0.1 alpha
Runtime
Node.js ESM
Access
Private preview
presence-session.mjs JavaScript 
import {
  RuntimeEngine,
  InMemoryEndpointAdapter
} from "@reality-relay/sdk";

const runtime = new RuntimeEngine();

runtime.registerEndpoint(space, adapter);
runtime.registerScene(scene);

const session = await runtime.startSession({
  endpointId: "space-portrait-01",
  sceneId: "expert-welcome"
});

// Presence is now playing in the Space.
Local runtime verified 18 passing tests
01

The model

A small surface for a physical system.

Scene. Space.
Session.

The SDK keeps content intent, endpoint capability and live state separate—so one presence experience can move across compatible formats without rewriting the application.

  1. 01 / SCENE

    What should appear

    Content, presentation intent, interaction modes and the Presence Profile travel together in one versioned manifest.

    registerScene(manifest)
  2. 02 / SPACE

    Where it will appear

    Resolution, display mode, calibration and capabilities describe the physical endpoint through an adapter.

    registerEndpoint(profile, adapter)
  3. 03 / SESSION

    What is happening now

    Prepare, play, pause, switch, observe and stop through a predictable lifecycle with typed events.

    startSession({ endpointId, sceneId })
02

SDK surface

The foundation is executable today.

Four contracts.
One presence layer.

SCENE

Scene contracts

Validate video, images, live streams, 3D scenes, digital humans and AI agents against one manifest.

validateSceneManifest()
PRESENCE

Presence Check

Evaluate safe area, full-body framing, contact line, attached shadow, camera stability and proof status.

evaluatePresenceAnalysis()
RUNTIME

Runtime lifecycle

Negotiate endpoint capabilities and operate a stateful session without coupling the app to display hardware.

RuntimeEngine
GENERATION

AI video planning

Compile a Presence Brief into a provider-independent, portrait display plan with required checks and provenance.

compilePresenceVideoPlan()
03

Quickstart

Private SDK alpha

From zero to a running session.

The alpha is currently installed from the checked-out package. It is not yet published to a public package registry and does not claim a hosted control plane.

01

Install the private package

During the design-partner alpha, link the SDK from an approved local checkout or private source repository.

npm install /path/to/realityrelay-platform
02

Define a Presence Scene

A Scene says what the experience needs—not how a particular display implements it.

const scene = {
  id: "expert-welcome",
  version: "1.0.0",
  title: "Expert welcome",
  content: {
    type: "video",
    uri: "./expert-welcome.mp4"
  },
  requiredCapabilities: ["video", "portrait"],
  presentation: {
    grounded: true,
    grounding: { contactLine: 0.905, shadowEnd: 0.94 }
  }
};
03

Register a Space adapter

The adapter translates the common lifecycle into the commands understood by one endpoint.

runtime.registerEndpoint({
  id: "space-portrait-01",
  label: "Portrait prototype",
  mode: "hld",
  resolution: { width: 1080, height: 1920 },
  capabilities: ["video", "portrait"],
  calibration: { contactLine: 0.905 }
}, new InMemoryEndpointAdapter());
04

Start and observe a Session

Every state transition produces an event with a timestamp and structured detail.

runtime.on("*", ({ type, detail, timestamp }) => {
  console.log(type, detail, timestamp);
});

const session = await runtime.startSession({
  endpointId: "space-portrait-01",
  sceneId: "expert-welcome"
});

await runtime.pause(session.id);
await runtime.play(session.id);
await runtime.stop(session.id);
05

Plan display-native AI video

A Presence Brief becomes a constrained generation plan—not an unchecked raw prompt. The plan fixes the 9:16 master and records the checks required before physical publication.

const plan = compilePresenceVideoPlan({
  id: "guide-welcome-plan",
  brief,
  presenceProfile,
  provider
});

console.log(plan.displayMaster);
// 1080 × 1920 · 24 fps · H.264 · yuv420p
04

Availability

The boundary is explicit.

What works now.
What comes next.

Available in SDK 0.1 alpha

  • Typed JavaScript ESM package
  • Scene and endpoint validation
  • Capability negotiation
  • Session lifecycle and events
  • In-memory reference adapter
  • Presence Profile evaluation
  • AI video plan compilation
  • Deterministic provider simulator

Planned hosted platform

  • Remote Space registry
  • Cloud session control plane
  • Upload and asset APIs
  • Production generation providers
  • Webhooks and service credentials
  • Fleet health and observability
  • Multi-Space orchestration
  • Public package registry release

Design partner access

Build the first
presence application.

Bring one valuable use case and one target Space. We will help map it to the SDK and prove it on the physical endpoint.

Request SDK access Explore the Platform