pub struct SessionResumeParams {
pub command_id: String,
pub recovery_mode: Option<RecoveryMode>,
pub session_id: String,
pub cursor: Option<String>,
pub exclude_items: Option<bool>,
pub history: Option<HistoryPreference>,
pub permission_profile: Option<String>,
pub config: Option<SessionConfig>,
}Expand description
session/resume params.
Fields§
§command_id: StringThe idempotency handle (UUIDv7). A resume that loads a session writes a
durable SessionResumed record.
recovery_mode: Option<RecoveryMode>Cold-resume replacement choice; omission preserves the retained choice. A warm attach rejects a different or unestablished choice as invalidParams. Explicit null is invalid.
session_id: StringThe session to load.
cursor: Option<String>A view cursor previously observed by this client — or an observed
summarizedThrough compaction anchor. When it names an event the server
still holds, the server returns only the suffix and history.mode is
none. A cursor the server minted that names no event yet, such as the
empty start cursor of a session that had no events, is treated as no
cursor: the server serves what a resume without a cursor would. A cursor
older than the earliest event the server still holds gets a snapshot, or
-32040 viewTruncated when none fits. A cursor this session’s view
never minted is refused with -32011 notFound, reason
missingAnchor, and a compaction anchor naming a boundary the server
has pruned is refused with -32042 boundaryPruned. Omitted and
explicit null both mean “no cursor”.
exclude_items: Option<bool>Return only session metadata and live resume state; page history
separately with view/page. Default false.
history: Option<HistoryPreference>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.
permission_profile: Option<String>The launch permission-profile pick: a profile id the host catalog
already admits. Select, never create. Omitted restores retained
authority only, with no override. The host restores first, then applies
the pick in the same pre-marker step; over a declared lost record the
restore is the never-wider reset, committed before the pick, and where
the reset cannot commit the pick is committed alone as that reset. 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).
config: Option<SessionConfig>The same open construction-time extension object as session/start.