session/start

Creates a brand-new session, loads it on this host, durably records the start, and auto-subscribes this connection.

Parameters

Type: SessionStartParams

session/start params.

Field	Type	Stability	Presence	Description
approvalMode	ApprovalMode | null		optional	The session’s starting approval mode; server default when omitted or explicit null — both spellings select the default. Select, never create — the value names a mode the host’s configuration already defines. This is the only surface that declares a non-interactive run’s policy.
commandId	string		required	The idempotency handle (UUIDv7). Required; the server never mints one.
config	SessionConfig		optional	Reserved for per-session overrides owned by a future Configuration section, which is why [SessionConfig] declares no members.
modelId	string		optional	Initial model; server default when omitted.
providerId	string | null		optional	Initial provider routing; server default when omitted or explicit null — both spellings select the default.
sessionId	string		optional	Exact identity for this new root session. When omitted the server mints a UUIDv7. This field never selects an existing session: a retained or reserved id is rejected commandRejected with reason session_id_conflict.
workspaceRoot	string		optional	Absolute path, folded into the first metadata record.

Source

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

{
  "description": "Creates a brand-new session, loads it on this host, durably records the start, and auto-subscribes this connection.",
  "params": {
    "$ref": "#/$defs/SessionStartParams"
  },
  "result": {
    "$ref": "#/$defs/SessionStartResult"
  }
}