remote/dev.s7a.strata.runtime.remote/RemoteMessage

RemoteMessage

Typed messages carried over an already established player connection. Session and sequence validation belongs to the connection/session owners, not the byte decoder.

Inheritors

Types

Acknowledgement

data class Acknowledgement(val session: Long, val sequence: Long, val revision: Long) : RemoteMessage

Confirms the largest processed action sequence and its authoritative resulting revision.

Action

data class Action(val session: Long, val sequence: Long, val endpoint: Long, val type: ProjectionType, val value: ProjectionValue) : RemoteMessage

Requests one registered typed action; the server authenticates its endpoint and sequence.

Applied

data class Applied(val session: Long, val revision: Long) : RemoteMessage

Confirms that the client validated and atomically installed a complete declaration revision. This is not proof that a frame was presented or that an operator saw it.

data class Close(val session: Long, val reason: RemoteFailure) : RemoteMessage

Ends one session, releasing both endpoints' retained references.

Control

data class Control(val session: Long, val state: RuntimeUiControl) : RemoteMessage

Server-ordered control request; declaration state and session identity remain unchanged.

ControlApplied

data class ControlApplied(val session: Long, val sequence: Long, val rejection: UiRejection? = null) : RemoteMessage

Native presentation/input application result, independent of declaration and framebuffer acknowledgements.

ControlReceipt

data class ControlReceipt(val session: Long, val sequence: Long, val rejection: UiRejection? = null) : RemoteMessage

Confirms admission of a client intent after any resulting server control, including no-op requests.

ControlRequest

data class ControlRequest(val session: Long, val state: RuntimeUiControl) : RemoteMessage

Authenticated client intent, ordered independently and sequenced by the owning server session.

Hello

class Hello(val protocol: Int, val limits: RemoteLimits, types: Set<ProjectionType>) : RemoteMessage

Negotiates the supported protocol and exact extension schemas before any screen is opened.

Resynchronize

data class Resynchronize(val session: Long) : RemoteMessage

Requests a fresh snapshot without replaying any actions.

Snapshot

data class Snapshot(val session: Long, val revision: Long, val title: ProjectionValue, val tree: RemoteTree, val pausesGame: Boolean = false, val settings: RemoteUiSettings = RemoteUiSettings(), val control: RuntimeUiControl? = null) : RemoteMessage

Opens or resynchronizes one complete screen; title is an unresolved typed text projection.

Update

data class Update(val session: Long, val baseRevision: Long, val revision: Long, val patch: RemotePatch) : RemoteMessage

Applies one atomic difference only when the client's committed revision matches baseRevision.

Properties

session

abstract val session: Long?

Terminal queue owner, or null for a connection-level greeting.