Enum FloatingSurfaceClientMessage 

pub enum FloatingSurfaceClientMessage {
    ActionMarkers {
        markers: Vec<PaintedActionMarker>,
    },
    MoveDeviceDisplay {
        request: u64,
        placement: DeviceDisplayMove,
    },
    DeviceShellOutcome {
        request: u64,
        result: Result<Value, String>,
    },
    AllowHostShell,
    OpenCaptureStudio {
        mode: CaptureStudioProtocolMode,
    },
    Present {
        request: FloatingSurfaceProtocolRequest,
    },
    UpdateRegion {
        id: String,
        region: [f64; 4],
    },
    SurfaceGeometry {
        id: String,
        rect: [f64; 4],
        content_rect: [f64; 4],
        input_rect: Option<[f64; 4]>,
    },
    SourceCleared {
        id: String,
    },
    DestinationPresented {
        id: String,
    },
    Suspend {
        id: String,
        rect: [f64; 4],
        content_rect: [f64; 4],
    },
    Dismiss {
        id: String,
    },
    SetCaptureProtection {
        protected: bool,
        generation: Option<u64>,
    },
    PaintStream {
        payload: String,
        page: [f64; 4],
        scale: f64,
    },
    PaintCapable,
    OpenTabBeside {
        target: Option<String>,
        background: bool,
        instance: Option<u64>,
    },
    CloseTab {
        instance: Option<u64>,
    },
    ReopenClosedTab,
    PlaceNextWindowBeside {
        background: bool,
        instance: Option<u64>,
    },
}

App → shell lifecycle. Suspend is the reversible half of an attached ↔ desktop handoff: the authenticated native surface and its renderer stay warm while its pixels return to the app. Dismiss is deliberately permanent and reserved for hang-up, navigation-end, or an explicit close.

Variants

ActionMarkers

Complete primary-surface marker inventory from a successfully presented SDK frame. The host resolves surface and room from launch custody.

Fields

markers: Vec<PaintedActionMarker>

MoveDeviceDisplay

A typed Settings request on the existing authenticated app connection.

Fields

request: u64

placement: DeviceDisplayMove

DeviceShellOutcome

Bounded response to a trusted owner operation on this same connection.

Fields

request: u64

result: Result<Value, String>

AllowHostShell

Terminal asks for the existing host-shell permission prompt.

OpenCaptureStudio

Ask the trusted session shell to show its ordinary user-confirmed chooser. This shares the same authenticated channel as floating surfaces so a separately hosted app and an embedded app have identical PiP UX.

Fields

mode: CaptureStudioProtocolMode

Present

Fields

request: FloatingSurfaceProtocolRequest

UpdateRegion

Fields

id: String

region: [f64; 4]

SurfaceGeometry

Live desktop placement of an app-owned secondary surface. The shell clamps it to the combined output before presentation.

Fields

id: String

rect: [f64; 4]

Full native-window bounds.

content_rect: [f64; 4]

Shared placement/hit geometry inside that transparent window.

input_rect: Option<[f64; 4]>

Interactive frame excluding shadow; absent means legacy window input.

SourceCleared

The primary window has presented a frame with the transferred pixels removed. The shell may now move its proxy/native surface away from the source rect without ever exposing two copies.

Fields

id: String

DestinationPresented

The primary app window has presented the first frame containing the reattached surface. Until this arrives, the compositor keeps a frozen copy of the last desktop-owned pixels in exactly the same place, so hiding the native secondary can never expose a blank transfer frame.

Fields

id: String

Suspend

Fields

id: String

rect: [f64; 4]

content_rect: [f64; 4]

Dismiss

Fields

id: String

SetCaptureProtection

Withhold every window of this app from captures — screenshots, recordings, screen sharing, remote viewers — or stop doing so. The local display is unaffected. The shell applies it to windows mapped later too, and drops it when this connection closes.

Fields

protected: bool

generation: Option<u64>

PaintStream

One frame of the page this app’s window shows, as a paint stream (tilo_paint_stream::wire::Payload, base64): the session shares it with web members as a display list they draw, instead of as video. page is where the page sits in the window, in logical pixels, and scale the window’s buffer scale, so the session can place input. Sent only while the shell has asked for it (FloatingSurfaceHostMessage::PaintKeyframe).

Fields

payload: String

page: [f64; 4]

scale: f64

PaintCapable

This app can stream its window’s page (sent once): the shell may ask it to with FloatingSurfaceHostMessage::PaintKeyframe.

OpenTabBeside

Open another instance of this app as a desktop tab right after this app’s own tab (see crate::shell_tabs). target is a URI the app’s manifest declares, or None for an empty instance. instance is the record instance the shell launched this process for; the shell only uses it to find a tab that already shows this same app.

Fields

target: Option<String>

background: bool

instance: Option<u64>

CloseTab

Close this app’s own tab through the desktop’s tab lifecycle.

Fields

instance: Option<u64>

ReopenClosedTab

Reopen the workspace’s most recently closed tab.

PlaceNextWindowBeside

The next window this app maps lands as a tab right after this one.

Fields

background: bool

instance: Option<u64>

Trait Implementations

impl Clone for FloatingSurfaceClientMessage

fn clone(&self) -> FloatingSurfaceClientMessage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FloatingSurfaceClientMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FloatingSurfaceClientMessage

fn deserialize<__D>( __deserializer: __D, ) -> Result<FloatingSurfaceClientMessage, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for FloatingSurfaceClientMessage

fn eq(&self, other: &FloatingSurfaceClientMessage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for FloatingSurfaceClientMessage

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FloatingSurfaceClientMessage