StartSessionOptions
Caller-facing options for session/start.
Class in muse_code
Composed from the generated SessionStartParams. config is excluded as well as commandId until the facade
implements the required sessionMcp grant check and forwarding.
Properties
Section titled “Properties”| Property | Type | Description |
|---|---|---|
approval_mode |
str | None |
The approval enforcement mode to start under; omitted = the host’s default. |
provider_id |
str | None |
The provider to serve the session with; omitted = the host’s default. |
session_id |
str | None |
A caller-chosen session id; omitted = the host mints one. |
workspace_root |
str | None |
The workspace the session works in; omitted = the host decides. |
workspace_roots |
List[str] | None |
The session’s initial runtime workspace-root set (wire workspaceRoots; first root = the CWD). When workspace_root is also given the two must agree. |
model_id |
str | None |
The model to serve the session with; omitted = the provider’s default. |
permission_profile |
str | None |
The permission profile to start the session under (wire permissionProfile): a profile id the host offers; omitted = the host’s configured default. An id the host does not offer refuses the start before the session exists. |
require_permission_profile |
bool |
Require the permission_profile selection: when true, the client proves the committed selection equals the requested id — from the start result’s session.permissionState, else a session/read read-back — and raises PermissionProfileNotApplied instead of proceeding on the host default. Client-local: never sent on the wire. Setting it without permission_profile is a usage error. |
Source
clients/sdk-py/src/muse_code/facade/client.py:77