generated/connect.pb
library
Classes
-
ConnectClientFrame
-
Every frame after the initial ClientHello handshake is carried in one of
these explicit envelopes. This leaves typed inference traffic untouched
while allowing clients to verify an otherwise-idle host connection.
-
ConnectClientHello
-
Sent by a client immediately after the platform transport is connected.
-
ConnectClientSessionState
-
The client validates the host response through commons and receives the
public session state it can expose to its platform UI.
-
ConnectClientStartRequest
-
-
ConnectDiscoveryMetadata
-
Non-secret metadata published through LAN service discovery and echoed by
the handshake.
instance_id is generated anew whenever the host starts;
it is not a persistent device identifier or a credential.
-
ConnectHandshakeResponse
-
Sent by the host after commons has accepted or rejected a client hello.
-
ConnectHandshakeStatus
-
-
ConnectHeartbeatRequest
-
The connection stays open between generations, so the client needs a
control-plane exchange that can detect a host stopped while chat is idle.
These frames deliberately remain separate from LLM invocation payloads:
a health check must never reach a model or appear as an assistant message.
-
ConnectHeartbeatResponse
-
-
ConnectHostFrame
-
-
ConnectHostStartRequest
-
-
ConnectHostState
-
-
ConnectHostStopRequest
-
-
ConnectInvocationCancelRequest
-
Clients cancel one in-flight generation by request id without tearing down
the TCP session. Commons validates session ownership; the host adapter then
cancels the local runtime for that request and emits a terminal stream event.
-
ConnectInvocationEvent
-
Hosts forward the SDK's canonical stream events without translating them to
a platform-specific token shape. This is the portable streaming surface for
future Kotlin, React Native, Flutter, and Web clients.
-
ConnectInvocationRequest
-
A client sends the existing typed LLM request to the selected host model.
session_id binds the request to the prior handshake; generation.model_id
must match the model the host published for that session.
-
ConnectInvocationValidation
-
Commons validates that an invocation belongs to an active session and uses
the host's published model before any platform runtime receives the prompt.
-
ConnectModelDescriptor
-
The single language model currently shared by a host. A host must select a
loaded model before it starts publishing; this lets clients enter chat
immediately without downloading or selecting a local model.
-
ConnectPlatform
-
Platform identity is explicit so commons can evaluate role availability
from one policy table. Presence of an enum value only reserves a stable
wire identity — it does NOT imply Connect support. Commons
ConnectPlatformPolicy (rac_connect.cpp) is the sole authority for which
platforms may host or client. Platform SDKs must query/enforce that table
rather than hardcoding the matrix in UI or transport code.
-
ConnectPlatformPolicy
-
Commons is the authority for this policy. SDKs may query it to shape UI,
but every host/client entrypoint also enforces it inside C++.
-
ConnectPlatformPolicyRequest
-
-
ConnectRoleAvailability
-
Role availability is richer than a boolean so the wire contract can reserve
planned platforms without accidentally advertising them as usable.
-
ConnectSessionCloseRequest
-
-
ConnectSessionState
-
