OptionalAvatarOPTIONAL — the session's live-avatar status (RealtimeAvatarStatus from @memberjunction/ai) as JSON: whether the
voiced agent asked for an avatar, whether the model renders it, and why not. The runtime reads it after connecting
to publish RealtimeSessionRuntime.AvatarNotice$. Absent from a server that predates it, when the agent asked
for no avatar, and from a host that mints for itself and does not pass it on; the call then shows no notice.
OptionalClientOPTIONAL — the server's resolved RealtimeSessionClientPolicy (from @memberjunction/ai-core-plus) as JSON: which of the channel
candidates the client reported at mint are in this session (agent/app scoping and the registry's
kill switch already applied), their resolved display and config, and the app/static client-tool
tiers. Absent from a server that predates channel scoping and from a host that mints through its
own proxy; the runtime then resolves the scope locally from code defaults and host declarations.
OptionalConnectionOPTIONAL — the catalog timing the server resolved for this session (ModelConfiguration.Realtime on the model and
model-vendor rows, narrowed to the driver's provider ceiling; TrustNativeResumption forced false for zero data
retention). The runtime hands them to the client driver on the typed ClientRealtimeSessionConfig fields, because
the server deliberately keeps them out of SessionConfigJson. Absent or null from a server that predates them and
from a host that mints for itself and does not pass them on; the driver then uses its own defaults.
The provider credential the client driver presents. Empty on a relay session, which has RelayUrl instead.
Display name of the realtime model the session uses (e.g. "GPT Realtime 2"). Null when unknown.
DB-driven progress-narration instruction template (contains a {{ progressMessage }}
placeholder). Null when the deployment hasn't synced the narration prompt — the client
falls back to its built-in wording.
JSON map of the PRIOR session's saved channel states keyed by channel name (present only
when the start carried lastSessionId and the prior session — owned by the same user —
had saved states). Applied to the matching channel plugins via
BaseRealtimeChannelClient.RestoreState so e.g. the whiteboard resumes where the
last session left off.
OptionalReconnectOptionalRelayOPTIONAL — where a relay session's client driver connects (MJAPI's realtime relay). It carries the session's ticket, so it is a credential: never log it. A host that mints for itself must pass it on for a relay session.
JSON.stringify of the provider session config (instructions + tools) to apply at connect.
OptionalSessionOptionalTransportOPTIONAL — how the browser reaches the provider: 'direct' or 'relay' (RealtimeClientTransport from
@memberjunction/ai). Absent, null or unknown means direct: a direct session, or a server that predates it.
OptionalTrust
Result shape returned by the
StartRealtimeClientSessionserver mutation. The browser uses these values to open a client-direct realtime session.Exported because a host may mint the session ITSELF (its own mutation, carrying server-side context the stock mutation cannot express) and then hand the result to RealtimeSessionRuntime.StartRealtimeSessionFromResult to run it — this is the contract that path is written against.