SessionStartParams

session/start params.

Fields and variants

• approvalMode
• commandId
• config
• modelId
• providerId
• sessionId
• workspaceRoot

Source

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

{
  "description": "`session/start` params.",
  "properties": {
    "approvalMode": {
      "anyOf": [
        {
          "$ref": "#/$defs/ApprovalMode"
        },
        {
          "type": "null"
        }
      ],
      "description": "The session's starting approval mode; server default when omitted or\nexplicit `null` — both spellings select the default.\nSelect, never create — the value names a mode the host's configuration\nalready defines. This is the only surface that\ndeclares a non-interactive run's policy."
    },
    "commandId": {
      "description": "The idempotency handle (UUIDv7). Required; the server never\nmints one.",
      "type": "string"
    },
    "config": {
      "$ref": "#/$defs/SessionConfig",
      "description": "Reserved for per-session overrides owned by a future Configuration\nsection, which is why [`SessionConfig`] declares no members."
    },
    "modelId": {
      "description": "Initial model; server default when omitted.",
      "type": "string"
    },
    "providerId": {
      "description": "Initial provider routing; server default when omitted or explicit\n`null` — both spellings select the default.",
      "type": [
        "string",
        "null"
      ]
    },
    "sessionId": {
      "description": "Exact identity for this new root session. When omitted the server\nmints a UUIDv7. This field never selects an existing session: a\nretained or reserved id is rejected `commandRejected` with reason\n`session_id_conflict`.",
      "type": "string"
    },
    "workspaceRoot": {
      "description": "Absolute path, folded into the first metadata record.",
      "type": "string"
    }
  },
  "required": [
    "commandId"
  ],
  "type": "object"
}