ResumeSessionOptions

Caller-facing options for session/resume.

Class in muse_code

Properties

Property	Type	Description
session_id	str	The session to resume.
cursor	str | None	Resume from this view cursor; omitted = from genesis.
exclude_items	bool | None	Ask the host to omit item bodies from the history.
history	Mapping[str, Any] | None	The history preference forwarded as the wire’s history member.
permission_profile	str | None	The permission profile pick forwarded as the wire’s permissionProfile member: the host restores the retained authority first, then applies the pick. Omitted means no override.
model_id	str | None	The model override forwarded as the wire’s modelId member: the host applies it after the warm pick, before enrichments. Omitted means no override.
recovery_mode	RecoveryMode | None	Optional recovery selection (wire recoveryMode); omitted means no selection is sent.
on_approval	ApprovalHandler | None	Answers this session’s approvals from its first frame, so an approval the host re-sends right after the resume reply reaches it. The same contract as Session.on_approval, installed before the frames that arrived with the reply are applied. Never sent on the wire.
on_approval_error	ApprovalFailureHandler | None	Hears this session’s approval failures from its first frame, as Session.on_approval_error does later, so a failure for an approval that arrived with the resume reply is heard whatever task the caller registers from. Never sent on the wire.
config	SessionConfig | None	Per-session configuration, as at start: naming MCP servers needs the host’s sessionMcp grant.

Source

clients/sdk-py/src/muse_code/facade/client.py:186