pub struct SessionResumeParams {Show 16 fields
pub command_id: String,
pub recovery_mode: Option<RecoveryMode>,
pub session_id: String,
pub workspace_root: Option<String>,
pub workspace_roots: Option<Vec<String>>,
pub cursor: Option<String>,
pub exclude_items: Option<bool>,
pub history: Option<HistoryPreference>,
pub permission_profile: Option<String>,
pub model_id: Option<String>,
pub config: Option<SessionConfig>,
pub continue_paused_source: Option<ContinuePausedSource>,
pub approval_rules: Option<Vec<ClientApprovalRule>>,
pub missing_input_assets: Option<MissingInputAssets>,
pub limits: Option<SessionLimitsChoice>,
pub auto_recover: Option<bool>,
}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.
workspace_root: Option<String>Relocate the resumed session to this folder. Same rules as
session/start.workspaceRoot: absolute, existing, and when
workspaceRoots is also present it names the same folder as
workspaceRoots[0] (canonical forms). The session’s durable identity
does not change; Project Trust is evaluated for the relocated folder.
Omitted: the recorded root, as today. Experimental
(session/resume.workspaceRoot).
workspace_roots: Option<Vec<String>>The resumed session’s runtime workspace-root set, with
session/start.workspaceRoots’s rules (the first root is the working
directory; explicit null is invalid params). Present, it relocates the
session and later resumes keep it; omitted, the latest recorded set.
Experimental (session/resume.workspaceRoots).
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).
model_id: Option<String>The explicit MSP model override: a model string the caller supplies at
resume time. When present it wins over the retained binding’s recorded
origin — over a stamped label and over a stamped pin — and it recovers
an otherwise-unresolved label binding by sending the override as the
wire model instead of the unresolved refusal. Omitted preserves arm (2):
the retained binding resolves by recorded origin exactly as without this
member. Explicit null is invalid params (the same closed null-tolerant
set as at start). The override changes the model within the retained
provider; it never names a provider. A resume that loads the session
records it as a resume --model records: nothing when it already is the
session’s model, else one durable selection with the provider’s profile
for that model. A resume that attaches to a loaded session switches the
model live. A model the host refuses, a blank one included, leaves the
session on its recorded model, which session.modelId reports; a
connection that opted into experimentalApi also gets the reason in
modelIdRefusal.
config: Option<SessionConfig>The same open construction-time extension object as session/start.
continue_paused_source: Option<ContinuePausedSource>the governing rules optional actor-bound explicit continuation object: the explicit user Resume action supplies it for a loaded paused source; absent or null keeps current resume behavior and does not release this feature’s loaded-source hold. Nullable. Standalone DTO (T-50280-074): the real effect is T-50280-084’s.
approval_rules: Option<Vec<ClientApprovalRule>>Client-supplied shell prefix allow-rules override: omitted reinstalls
the session’s rules from the audit fact, present replaces with that set
(an explicit empty array clears). Explicit null is invalid params.
Until the served-handler slice, a host refuses any spelled
approvalRules on session/start/fork/resume with -32602;
clients omit it. Experimental (session/resume.approvalRules).
missing_input_assets: Option<MissingInputAssets>What a cold load does with a retained input image whose file is missing
or corrupt. Omitted means fail; explicit null is invalid params.
Only the resume that loads the session reads it; an attach ignores it.
Experimental (session/resume.missingInputAssets).
limits: Option<SessionLimitsChoice>The trust ask for the session this resume loads:
session/start.limits’s shape, of which a resume names only
workspaceTrusted. Naming another axis is invalid params: a resumed
session keeps its stored sandbox, write and shell limits. The ask takes
the place of the session’s stored trust choice, made or not, and the
load records it as the session’s choice; the host’s ceiling bounds it as
it bounds a stored one (tightenedAxes names a clamp). Only the resume
that loads the session reads it; an attach ignores it. Experimental,
served only by the per-run host a TUI run starts
(session/resume.limits; unopted callers are refused -32602, as are
opted callers on every other host, where a session resumes with its
saved trust choice, which an earlier ask on a TUI run’s host may have
replaced, a fork or side-chat child included). Explicit null is
invalid params.
auto_recover: Option<bool>This resume’s auto-recover choice (amendment 26387/68619, owner decision
G-37): omitted or true follows the host’s resume_auto_recover gate,
which stays the master switch; false holds a crash resume under the
governing rules and reports autoRecovery refused with reason
optedOut. Decided for this resume only: it is not saved. Only the
resume that loads the session reads it; an attach ignores it. Explicit
null is invalid params. Experimental
(session/resume.autoRecover).