Struct FloatingSurfaceServiceClient 

pub struct FloatingSurfaceServiceClient { /* private fields */ }

Non-blocking app-side connection to the session shell. The launcher hands the already-connected socket into the sandbox as TILO_SVC_SHELL-UI_FD; newline-delimited JSON keeps the tiny lifecycle protocol inspectable and lets the compositor service evolve independently of app/widget releases.

Implementations

impl FloatingSurfaceServiceClient

pub fn discover() -> Option<FloatingSurfaceServiceClient>

Discover the optional session service. Outside Tilo (or on an older shell) this returns None; apps retain their ordinary attached UI. The inherited descriptor belongs to one app launch. Transport loss is terminal for this client; only a fresh launcher-mediated launch supplies a new connection. Discovery never opens a privileged host socket.

pub fn send( &mut self, message: &FloatingSurfaceClientMessage, ) -> Result<(), String>

Queue and flush one client message.

Errors

Returns an error when the message cannot be encoded, exceeds the protocol limit, or cannot be written to the service stream.

pub fn pump(&mut self) -> Result<Vec<FloatingSurfaceHostMessage>, String>

Flush queued writes and collect every complete host message currently available. WouldBlock is ordinary idle state, never a disconnect.

Errors

Returns an error when queued writes or incoming reads fail, the peer disconnects, a frame exceeds the protocol limit, or JSON is invalid.