51 lines
1.8 KiB
Plaintext
51 lines
1.8 KiB
Plaintext
|
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"
|
||
|
|
}
|