name: start_session

description:
Optionally create or return a lifecycle session before acting. For multi-call work, prefer a short public `session` label and repeat it on every call that accepts it; an omitted value uses the authenticated transport lease's implicit session instead. This tool is optional because an ordinary action can create or reuse a named run directly. Use it to set the initial cursor theme before acting or to revive a public name after it has ended; ordinary actions never revive ended names. `capture_scope` is deprecated compatibility input; new callers select window or desktop modality per action. Idempotent.

input_schema:
{
  "additionalProperties": true,
  "properties": {
    "capture_scope": {
      "description": "Deprecated compatibility policy. New callers select window or desktop\nmodality on each action instead of storing it on the session.",
      "enum": [
        "auto",
        "window",
        "desktop"
      ],
      "type": "string"
    },
    "cursor_theme": {
      "description": "Optional initial cursor theme. The host applies it before the cursor is\nfirst made visible, avoiding a flash of the default theme.",
      "properties": {
        "reduced_motion": {
          "default": "auto",
          "enum": [
            "auto",
            "on",
            "off"
          ],
          "type": "string"
        },
        "theme_id": {
          "type": "string"
        }
      },
      "required": [
        "theme_id"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "session": {
      "description": "Optional stable public label for this run (e.g. \"research-run-1\").\nWhen omitted, the authenticated transport lease's implicit session is\ncreated or returned.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
