session/userShell

Runs a user-initiated shell command in the session’s workspace; capability-gated on userShell.

Parameters

Type: SessionUserShellParams

session/userShell params: run a user-initiated shell command in the session’s workspace — the TUI’s ! escape hatch. Capability-gated: the connection must negotiate userShell at initialize, and the whole justification is the spawn boundary.

Field	Type	Stability	Presence	Description
commandId	string		required	The idempotency handle (UUIDv7).
commandText	string		required	The shell command to run.
sessionId	string		required	The target session.

Source

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

{
  "description": "Runs a user-initiated shell command in the session's workspace; capability-gated on `userShell`.",
  "params": {
    "$ref": "#/$defs/SessionUserShellParams"
  },
  "result": {
    "$ref": "#/$defs/SessionUserShellResult"
  }
}