TurnStartParams

turn/start.providerRequestOptions is deliberately absent: RULED to stay off the published schema. The schema is the contract, and a free-form-object node kind is revisited only if the experimental field graduates. turn/start params.

Fields and variants

• commandId
• displayText
• ifBusy
• input
• reasoningEffort
• sessionId

Source

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

{
  "description": "`turn/start.providerRequestOptions` is deliberately absent: **RULED to stay off the published schema.** The\nschema is the contract, and a free-form-object node kind is revisited only\nif the experimental field graduates.\n`turn/start` params.",
  "properties": {
    "commandId": {
      "description": "The idempotency handle (UUIDv7). The fresh turn's `turnId`\nderives from it.",
      "type": "string"
    },
    "displayText": {
      "description": "Presentation form of the prompt for transcripts. Durable; carried on\nthe resulting user-message view item. Never model-visible.",
      "type": "string"
    },
    "ifBusy": {
      "$ref": "#/$defs/IfBusy",
      "description": "Disposition when a turn is already running; default `queue`."
    },
    "input": {
      "description": "Ordered content parts; required and non-empty.",
      "items": {
        "$ref": "#/$defs/TurnInputPart"
      },
      "type": "array"
    },
    "reasoningEffort": {
      "$ref": "#/$defs/ReasoningEffort",
      "description": "Reasoning tier sampled at submission for this turn."
    },
    "sessionId": {
      "description": "The target session.",
      "type": "string"
    }
  },
  "required": [
    "commandId",
    "input",
    "sessionId"
  ],
  "type": "object"
}