remote/dev.s7a.strata.runtime.remote/RemoteClientSession

RemoteClientSession

class RemoteClientSession(snapshot: RemoteMessage.Snapshot, registry: RemoteRegistry, limits: RemoteLimits = RemoteLimits(), send: (RemoteMessage) -> Unit) : AutoCloseable(source)

One client-side retained declaration source bound to a server-issued session identity. All calls run under the construction execution owner; network receivers must enqueue work for that owner. Invalid patch bases request one snapshot; actions are never replayed during resynchronization.

Constructors

RemoteClientSession

constructor(snapshot: RemoteMessage.Snapshot, registry: RemoteRegistry, limits: RemoteLimits = RemoteLimits(), send: (RemoteMessage) -> Unit)

Properties

identity

val identity: Long

nodeCount

val nodeCount: Int

Current declaration count for connection-wide admission.

status

var status: RemoteSessionStatus

uiSession

val uiSession: UiSession

Receiver for synchronous client extension events; all controls are sequenced by the server.

Functions

bindUiSession

fun bindUiSession(session: UiSession)

Binds native ownership once opening has succeeded.

open override fun close()

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

Ends this screen and releases its tree and transport captures, even if sending close fails.

controlApplied

fun controlApplied(state: RuntimeUiControl, rejection: UiRejection?)

Records native application without accepting older authoritative controls.

definition

fun definition(title: UiText): UiDefinition

Creates one ordinary screen whose content observes committed remote declarations. The enclosing platform owns presentation and must close this session when that screen terminates.

flushEdits

fun flushEdits()

Flushes committed text edits before the adapter flushes its bounded outgoing transport.

receive

fun receive(acknowledgement: RemoteMessage.Acknowledgement)

Records an ordered acknowledgement without acknowledging unsent client operations.

fun receive(receipt: RemoteMessage.ControlReceipt)

Completes only the matching client intent; authoritative application is reported separately.

fun receive(snapshot: RemoteMessage.Snapshot)

Accepts a complete newer snapshot without replacing the screen host or replaying actions.

fun receive(update: RemoteMessage.Update)

Applies an atomic validated patch, or requests a snapshot when its base is unavailable.

synchronizeInteraction

fun synchronizeInteraction()

Reports native interaction termination, including Escape, hidden HUDs, and focus loss, to the owning server. Call after native lifecycle processing; unchanged modes never enqueue another request.