session/resume

Loads a stored session on this host, auto-subscribes this connection, and returns the history needed to render it.

Parameters

Type: SessionResumeParams

session/resume params.

Field	Type	Stability	Presence	Description
commandId	string		required	The idempotency handle (UUIDv7). A resume that loads a session writes a durable SessionResumed record.
config	SessionConfig		optional	The same open construction-time extension object as session/start.
cursor	string | null		optional	A view cursor previously observed by this client — or an observed summarizedThrough compaction anchor. When present the server returns only the suffix and history.mode is none. Omitted and explicit null both mean “no cursor”.
excludeItems	boolean		optional	Return only session metadata and live resume state; page history separately with view/page. Default false.
history	HistoryPreference		optional	History mode preference, default auto. A PREFERENCE, not a budget override: when the requested mode does not fit the history budget the server downgrades it and history.mode reports what was actually served. Ignored when cursor or excludeItems makes it moot.
permissionProfile	string		optional	The launch permission-profile pick: a profile id the host catalog already admits. Select, never create. Omitted means today’s behavior: restore retained authority only, no override. The host restores first, then applies the pick in the same pre-marker step; a pick that fails admission refuses the resume commandRejected (-32030; permission_profile_unknown / permission_profile_unavailable) before any durable byte. Explicit null is invalid params (the same closed null-tolerant set as at start).
sessionId	string		required	The session to load.

Source

schema/msp/experimental/msp.schema.json#/methods/session~2Fresume

{
  "description": "Loads a stored session on this host, auto-subscribes this connection, and returns the history needed to render it.",
  "params": {
    "$ref": "#/$defs/SessionResumeParams"
  },
  "result": {
    "$ref": "#/$defs/SessionResumeResult"
  }
}