remote/dev.s7a.strata.runtime.remote/RemoteServerSession

RemoteServerSession

class RemoteServerSession(val identity: Long, title: ProjectionValue, supportedTypes: Set<ProjectionType>, limits: RemoteLimits = RemoteLimits(), send: (RemoteMessage) -> Unit, pausesGame: Boolean = false, eventSession: UiSession? = null, controller: RuntimeUiController? = null, settings: RemoteUiSettings = RemoteUiSettings(), content: () -> Element) : AutoCloseable(source)

One authoritative screen bound by its transport owner to one authenticated connection. All calls run under the construction execution owner; source callbacks remain owned by the shared core session. Only the current tree and current action table are retained, and terminal cleanup releases both.

Constructors

RemoteServerSession

constructor(identity: Long, title: ProjectionValue, supportedTypes: Set<ProjectionType>, limits: RemoteLimits = RemoteLimits(), send: (RemoteMessage) -> Unit, pausesGame: Boolean = false, eventSession: UiSession? = null, controller: RuntimeUiController? = null, settings: RemoteUiSettings = RemoteUiSettings(), content: () -> Element)

Properties

appliedRevision

var appliedRevision: Long

Largest revision the authenticated client has confirmed installing, or zero before its first confirmation. A confirmation does not establish that native rendering or human observation has occurred.

identity

val identity: Long

nodeCount

val nodeCount: Int

Current retained node count for the owning connection's aggregate budget.

requiredTypes

var requiredTypes: Set<ProjectionType>

Exact component, modifier, and nested behavior schemas required by the currently committed screen. The transport owner can withdraw extension ownership and close affected screens before unloading its plugin.

status

var status: RemoteSessionStatus

uiSession

val uiSession: UiSession

Receiver for authenticated events; a transport owner may supply its public facade.

usesNativeSlots

val usesNativeSlots: Boolean

Whether current declarations depend on the native container generation.

Functions

applyControl

fun applyControl(request: RuntimeUiControl)

Receives a request sequenced by the transport's owning public session.

open override fun close()

fun close(reason: RemoteFailure, notifyPeer: Boolean = true)

Ends ownership and optionally notifies the peer; notification failure cannot skip cleanup.

receive

fun receive(message: RemoteMessage)

Accepts a typed action or declaration acknowledgement from this session's authenticated connection. Future or cross-session acknowledgements fail the session; duplicates and older confirmations are harmless.

fun receive(action: RemoteMessage.Action)

Validates an ordered peer action before invoking it through the core input boundary. Duplicate or retired endpoints never execute callbacks; their sequences are still acknowledged.

resynchronize

fun resynchronize()

Sends the last committed complete snapshot without replaying any operations.

tick

fun tick()

Attaches once, commits the declaration cutoff, and sends an initial snapshot or changed records.