session/branchChanged

A durable workspace-branch observation landed; null branch is a detached-HEAD fact.

Parameters

Type: SessionBranchChangedParams

session/branchChanged params: a durable workspace-branch observation landed.

Field	Type	Stability	Presence	Description
branch	string		optional	The observed branch; null on a detached-HEAD observation — a fact, not “unchanged”.
sessionId	string		required	The owning session.
sourceRange	SourceRange		required	The durable records this event folded from.
vcs	Vcs		optional	The detected version-control system; absent when no repository was detected.
viewCursor	string		required	Opaque, strictly monotonic view cursor.
workspaceRoot	string		required	The observed workspace root.

Source

schema/msp/experimental/msp.schema.json#/notifications/session~2FbranchChanged

{
  "description": "A durable workspace-branch observation landed; null branch is a detached-HEAD fact.",
  "params": {
    "$ref": "#/$defs/SessionBranchChangedParams"
  }
}