Skip to content
Developer Preview

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.

  • commandId
  • commandText
  • sessionId
Source

schema/msp/experimental/msp.schema.json#/types/SessionUserShellParams

{
"description": "`session/userShell` params: run a user-initiated shell command\nin the session's workspace — the TUI's `!` escape hatch.\n**Capability-gated**: the connection must negotiate `userShell` at\n`initialize`, and the whole justification is the spawn boundary.",
"properties": {
"commandId": {
"description": "The idempotency handle (UUIDv7).",
"type": "string"
},
"commandText": {
"description": "The shell command to run.",
"type": "string"
},
"sessionId": {
"description": "The target session.",
"type": "string"
}
},
"required": [
"commandId",
"commandText",
"sessionId"
],
"type": "object"
}