pub struct SessionSummaryChangedParams {
pub channel: Uri,
pub session: Uri,
pub changes: PartialSessionSummary,
}Expand description
Broadcast to all clients subscribed to the root channel when an existing
session’s summary changes (title, status, modifiedAt, model, working
directory, read/done state, or diff statistics).
This notification lets clients that maintain a cached session list — for
example, the result of a previous listSessions() call — stay in sync with
in-flight sessions without having to subscribe to every session URI
individually. It is complementary to, not a replacement for,
root/sessionAdded and root/sessionRemoved: those signal lifecycle
(creation/disposal), while this signals summary-level mutations on an
already-known session.
Semantics:
- Only fields present in
changeshave new values; omitted fields are unchanged on the client’s cached summary. - Identity fields (
resource,provider,createdAt) never change and are not carried. - Like all protocol notifications, this is ephemeral: it is not
replayed on reconnect. On reconnect, clients should re-fetch the full
catalog via
listSessions()as usual. - The server SHOULD emit this notification whenever any mutable field on
{@link SessionSummary |
SessionSummary} changes for a session the server has surfaced vialistSessions()orroot/sessionAdded. Servers MAY coalesce or debounce updates for noisy fields (for example,modifiedAtbumps while a turn is streaming) at their discretion. - Clients that have no cached entry for
sessionMAY ignore the notification; it is not a substitute forroot/sessionAdded.
Fields§
§channel: UriChannel URI this notification belongs to (the root channel)
session: UriURI of the session whose summary changed
changes: PartialSessionSummaryMutable summary fields that changed; omitted fields are unchanged.
Identity fields (resource, provider, createdAt) never change and
MUST be omitted by senders; receivers SHOULD ignore them if present.
Trait Implementations§
Source§impl Clone for SessionSummaryChangedParams
impl Clone for SessionSummaryChangedParams
Source§fn clone(&self) -> SessionSummaryChangedParams
fn clone(&self) -> SessionSummaryChangedParams
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for SessionSummaryChangedParams
impl Debug for SessionSummaryChangedParams
Source§impl<'de> Deserialize<'de> for SessionSummaryChangedParams
impl<'de> Deserialize<'de> for SessionSummaryChangedParams
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Source§impl PartialEq for SessionSummaryChangedParams
impl PartialEq for SessionSummaryChangedParams
Source§fn eq(&self, other: &SessionSummaryChangedParams) -> bool
fn eq(&self, other: &SessionSummaryChangedParams) -> bool
self and other values to be equal, and is used by ==.