WorktreeStartRequest

Experimental

session/start worktree param: absent means no worktree — the start proceeds exactly as today. Adjacently tagged on mode: a create carries an optional baseRef, an existing carries a required path (omitted path fails decode — the pre-existing invalid-params class, never a new message).

Fields and variants

• baseRef — Experimental
• mode — Experimental
• path — Experimental

Source

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

{
  "description": "`session/start` `worktree` param: absent\nmeans no worktree — the start proceeds exactly as today.\nAdjacently tagged on `mode`: a create carries an optional `baseRef`,\nan existing carries a required `path` (omitted `path` fails decode —\nthe pre-existing invalid-params class, never a new message).",
  "oneOf": [
    {
      "properties": {
        "baseRef": {
          "description": "The base to create from; omitted means `HEAD`.",
          "type": "string"
        },
        "mode": {
          "const": "create",
          "type": "string"
        }
      },
      "required": [
        "mode"
      ],
      "type": "object"
    },
    {
      "properties": {
        "mode": {
          "const": "existing",
          "type": "string"
        },
        "path": {
          "description": "The caller-provided worktree path to validate.",
          "type": "string"
        }
      },
      "required": [
        "mode",
        "path"
      ],
      "type": "object"
    }
  ],
  "x-msp-descriptor": "session/start.worktree",
  "x-msp-openness": "closed",
  "x-msp-stability": "experimental"
}