@agent-sh/computer-use-linux 0.7.43 → 0.7.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,9 +7,9 @@ export interface GeneratedMcpToolDefinition {
7
7
  annotations: Record<string, unknown>;
8
8
  }
9
9
 
10
- export const GENERATED_SERVER_VERSION = "0.7.43";
11
- export const GENERATED_TOOL_CATALOG_HASH = "c3da735e9c17d0bd15294e604abd28a6008e67d250f6db226da05e3f9504f68f";
12
- export const GENERATED_SHELL_TOOL_CATALOG_HASH = "96bd879e7d29ef3f3193d49ef6f86b0d561b2ac9c7eeeece326c1637e1c6428f";
10
+ export const GENERATED_SERVER_VERSION = "0.7.45";
11
+ export const GENERATED_TOOL_CATALOG_HASH = "70b08b6ea245fc2ad253b4b66e68d446536897cc2fa7948db3f961c7742f14f3";
12
+ export const GENERATED_SHELL_TOOL_CATALOG_HASH = "3a6ebca9aa371d244a0ca05f749647accec8ed1663760ae41d1ec2e1490eec31";
13
13
  export const GENERATED_MCP_TOOLS =
14
14
  [
15
15
  {
@@ -34,6 +34,7 @@ export const GENERATED_MCP_TOOLS =
34
34
  "properties": {
35
35
  "app_id": {
36
36
  "default": null,
37
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment outside a terminal match. A segment that matches several apps is\nrejected.",
37
38
  "type": [
38
39
  "string",
39
40
  "null"
@@ -51,7 +52,7 @@ export const GENERATED_MCP_TOOLS =
51
52
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
52
53
  },
53
54
  "include_tree": {
54
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
55
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
55
56
  "type": [
56
57
  "boolean",
57
58
  "null"
@@ -83,6 +84,7 @@ export const GENERATED_MCP_TOOLS =
83
84
  },
84
85
  "pid": {
85
86
  "default": null,
87
+ "description": "Process id. It must match exactly one window.",
86
88
  "minimum": 0,
87
89
  "type": [
88
90
  "integer",
@@ -126,6 +128,7 @@ export const GENERATED_MCP_TOOLS =
126
128
  },
127
129
  "terminal_command": {
128
130
  "default": null,
131
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
129
132
  "type": [
130
133
  "string",
131
134
  "null"
@@ -133,6 +136,7 @@ export const GENERATED_MCP_TOOLS =
133
136
  },
134
137
  "terminal_cwd": {
135
138
  "default": null,
139
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
136
140
  "type": [
137
141
  "string",
138
142
  "null"
@@ -140,6 +144,7 @@ export const GENERATED_MCP_TOOLS =
140
144
  },
141
145
  "terminal_pid": {
142
146
  "default": null,
147
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
143
148
  "minimum": 0,
144
149
  "type": [
145
150
  "integer",
@@ -148,6 +153,7 @@ export const GENERATED_MCP_TOOLS =
148
153
  },
149
154
  "title": {
150
155
  "default": null,
156
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
151
157
  "type": [
152
158
  "string",
153
159
  "null"
@@ -155,6 +161,7 @@ export const GENERATED_MCP_TOOLS =
155
161
  },
156
162
  "tty": {
157
163
  "default": null,
164
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
158
165
  "type": [
159
166
  "string",
160
167
  "null"
@@ -162,6 +169,7 @@ export const GENERATED_MCP_TOOLS =
162
169
  },
163
170
  "window_id": {
164
171
  "default": null,
172
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, terminal fields, pid, app_id,\nwm_class, title. With a terminal field, pid, app_id, wm_class and title\nonly narrow the terminal match, which must name one window.",
165
173
  "maximum": 9007199254740991,
166
174
  "minimum": 0,
167
175
  "type": [
@@ -171,6 +179,7 @@ export const GENERATED_MCP_TOOLS =
171
179
  },
172
180
  "wm_class": {
173
181
  "default": null,
182
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
174
183
  "type": [
175
184
  "string",
176
185
  "null"
@@ -188,7 +197,7 @@ export const GENERATED_MCP_TOOLS =
188
197
  "openWorldHint": true,
189
198
  "readOnlyHint": false
190
199
  },
191
- "description": "Click an element by index, semantic selector, or desktop coordinate pixels from screenshot metadata. Plain left activation prefers a native AT-SPI click/press/toggle action, avoiding toolkit coordinate scaling. Entry activate and slider jump actions are not substituted for pointer clicks. Explicit coordinates, right clicks, and multi-clicks retain pointer semantics. Explicit x/y default to raw screenshot capture pixels; coordinate_space=\"atspi\" with element_index or a semantic selector maps a global AT-SPI screen point through the element's KWin window and output geometry on KDE Wayland. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
200
+ "description": "Click an element by index, semantic selector, or desktop coordinate pixels from screenshot metadata. A plain left click on an element whose first AT-SPI action is click, press, or toggle invokes that action, avoiding toolkit coordinate scaling. Entry activate and slider jump actions are not substituted for pointer clicks. Explicit coordinates, right clicks, and multi-clicks retain pointer semantics. Explicit x/y default to raw screenshot capture pixels; coordinate_space=\"atspi\" with element_index or a semantic selector maps a global AT-SPI screen point through the element's KWin window and output geometry on KDE Wayland. A window target is raised and focused first (on GNOME Wayland, raising needs the Shell extension); nothing is sent when focus cannot be verified. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
192
201
  "inputSchema": {
193
202
  "$defs": {
194
203
  "ClickCoordinateSpace": {
@@ -210,6 +219,7 @@ export const GENERATED_MCP_TOOLS =
210
219
  "properties": {
211
220
  "app_id": {
212
221
  "default": null,
222
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment. A segment that matches several apps is\nrejected.",
213
223
  "type": [
214
224
  "string",
215
225
  "null"
@@ -217,6 +227,7 @@ export const GENERATED_MCP_TOOLS =
217
227
  },
218
228
  "button": {
219
229
  "default": null,
230
+ "description": "Mouse button: left (default), right or middle. side, extra, forward and\nback reach only the portal and ydotool routes, which treat an unknown\nname as left. Native X11 refuses any other name.",
220
231
  "type": [
221
232
  "string",
222
233
  "null"
@@ -224,6 +235,7 @@ export const GENERATED_MCP_TOOLS =
224
235
  },
225
236
  "click_count": {
226
237
  "default": null,
238
+ "description": "Number of clicks (default 1), clamped to 1 to 10.",
227
239
  "minimum": 0,
228
240
  "type": [
229
241
  "integer",
@@ -237,6 +249,7 @@ export const GENERATED_MCP_TOOLS =
237
249
  },
238
250
  "element_index": {
239
251
  "default": null,
252
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
240
253
  "minimum": 0,
241
254
  "type": [
242
255
  "integer",
@@ -255,7 +268,7 @@ export const GENERATED_MCP_TOOLS =
255
268
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
256
269
  },
257
270
  "include_tree": {
258
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
271
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
259
272
  "type": [
260
273
  "boolean",
261
274
  "null"
@@ -287,6 +300,7 @@ export const GENERATED_MCP_TOOLS =
287
300
  },
288
301
  "name": {
289
302
  "default": null,
303
+ "description": "Case-insensitive substring of the element's accessible name.",
290
304
  "type": [
291
305
  "string",
292
306
  "null"
@@ -294,6 +308,7 @@ export const GENERATED_MCP_TOOLS =
294
308
  },
295
309
  "pid": {
296
310
  "default": null,
311
+ "description": "Process id. It must match exactly one window.",
297
312
  "minimum": 0,
298
313
  "type": [
299
314
  "integer",
@@ -319,6 +334,7 @@ export const GENERATED_MCP_TOOLS =
319
334
  },
320
335
  "role": {
321
336
  "default": null,
337
+ "description": "Case-insensitive substring of the element's AT-SPI role.",
322
338
  "type": [
323
339
  "string",
324
340
  "null"
@@ -352,6 +368,7 @@ export const GENERATED_MCP_TOOLS =
352
368
  },
353
369
  "states": {
354
370
  "default": [],
371
+ "description": "AT-SPI states the element must all have, case-insensitive (for\nexample focused, checked).",
355
372
  "items": {
356
373
  "type": "string"
357
374
  },
@@ -359,6 +376,7 @@ export const GENERATED_MCP_TOOLS =
359
376
  },
360
377
  "text": {
361
378
  "default": null,
379
+ "description": "Case-insensitive substring of the element's text, name or description.",
362
380
  "type": [
363
381
  "string",
364
382
  "null"
@@ -366,6 +384,7 @@ export const GENERATED_MCP_TOOLS =
366
384
  },
367
385
  "window_id": {
368
386
  "default": null,
387
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, pid, app_id, wm_class, window_title.",
369
388
  "maximum": 9007199254740991,
370
389
  "minimum": 0,
371
390
  "type": [
@@ -375,6 +394,7 @@ export const GENERATED_MCP_TOOLS =
375
394
  },
376
395
  "window_title": {
377
396
  "default": null,
397
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch, the first wins.\nThis tool names the field window_title; a title field is ignored.",
378
398
  "type": [
379
399
  "string",
380
400
  "null"
@@ -382,6 +402,7 @@ export const GENERATED_MCP_TOOLS =
382
402
  },
383
403
  "wm_class": {
384
404
  "default": null,
405
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
385
406
  "type": [
386
407
  "string",
387
408
  "null"
@@ -389,6 +410,7 @@ export const GENERATED_MCP_TOOLS =
389
410
  },
390
411
  "x": {
391
412
  "default": null,
413
+ "description": "Point x in raw screenshot capture pixels: the coordinate_width and\ncoordinate_height space. Divide preview pixels by the screenshot scale\nfirst. With relative=true, measured from the window screenshot's crop origin.",
392
414
  "format": "int32",
393
415
  "type": [
394
416
  "integer",
@@ -397,6 +419,7 @@ export const GENERATED_MCP_TOOLS =
397
419
  },
398
420
  "y": {
399
421
  "default": null,
422
+ "description": "Point y in raw screenshot capture pixels: the coordinate_width and\ncoordinate_height space. Divide preview pixels by the screenshot scale\nfirst. With relative=true, measured from the window screenshot's crop origin.",
400
423
  "format": "int32",
401
424
  "type": [
402
425
  "integer",
@@ -429,7 +452,7 @@ export const GENERATED_MCP_TOOLS =
429
452
  "openWorldHint": true,
430
453
  "readOnlyHint": false
431
454
  },
432
- "description": "Drag from one point to another using pixel coordinates. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
455
+ "description": "Drag with the left button from one point to another in screenshot capture pixels. Takes no window target or relative coordinates. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
433
456
  "inputSchema": {
434
457
  "$defs": {
435
458
  "ScreenshotOutputFormat": {
@@ -443,10 +466,12 @@ export const GENERATED_MCP_TOOLS =
443
466
  "$schema": "https://json-schema.org/draft/2020-12/schema",
444
467
  "properties": {
445
468
  "end_x": {
469
+ "description": "End x in raw screenshot capture pixels.",
446
470
  "format": "int32",
447
471
  "type": "integer"
448
472
  },
449
473
  "end_y": {
474
+ "description": "End y in raw screenshot capture pixels.",
450
475
  "format": "int32",
451
476
  "type": "integer"
452
477
  },
@@ -462,7 +487,7 @@ export const GENERATED_MCP_TOOLS =
462
487
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
463
488
  },
464
489
  "include_tree": {
465
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
490
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
466
491
  "type": [
467
492
  "boolean",
468
493
  "null"
@@ -528,10 +553,12 @@ export const GENERATED_MCP_TOOLS =
528
553
  "description": "Capture and return a post-action screenshot in the same result: `true` or\n`\"screen\"` captures the full desktop; `\"window\"` crops to the action's\ntarget window (or the focused window when untargeted); `false` disables capture."
529
554
  },
530
555
  "start_x": {
556
+ "description": "Start x in raw screenshot capture pixels: the coordinate_width space.\nDivide preview pixels by the screenshot scale first.",
531
557
  "format": "int32",
532
558
  "type": "integer"
533
559
  },
534
560
  "start_y": {
561
+ "description": "Start y in raw screenshot capture pixels.",
535
562
  "format": "int32",
536
563
  "type": "integer"
537
564
  }
@@ -567,7 +594,7 @@ export const GENERATED_MCP_TOOLS =
567
594
  "openWorldHint": true,
568
595
  "readOnlyHint": true
569
596
  },
570
- "description": "Start an app use session if needed, then get a size-bounded screenshot and accessibility state for a Linux app. Scope the accessibility tree with app_name_or_bundle_identifier or a window_id/pid/app_id/wm_class/title target; omitting a target returns the whole desktop tree and can flood context. Nodes are compact (empty fields left out, actions by name; verbose=true returns every field). Pass interactive_only=true for only actionable nodes, headings and status regions, with the same element_index values. A title or window_id target narrows an app with several windows under one AT-SPI root (Chromium) to that window, keeping the app's popups and dialogs. A tree too large to return inline is written whole to the private file in accessibility_tree_spill. Screenshot results include coordinate_width, coordinate_height, scale, format, and quality when the returned image is downscaled or compressed; callers can request jpeg/quality for compression before resizing.",
597
+ "description": "Get a size-bounded screenshot and accessibility state for a Linux app. Scope the accessibility tree with app_name_or_bundle_identifier or a window_id/pid/app_id/wm_class/title target; omitting a target returns the whole desktop tree and can flood context. Nodes are compact (empty fields left out, actions by name; verbose=true returns every field). Pass interactive_only=true for only actionable nodes, headings and status regions, with the same element_index values. A title or window_id target narrows an app with several windows under one AT-SPI root (Chromium) to that window, keeping the app's popups and dialogs. A window-targeted screenshot needs that window visible and already focused (outside Hyprland background mode); otherwise screenshot_error is set and the tree still returns, so use the screenshot tool to raise and capture it. A tree too large to return inline is written whole to the private file in accessibility_tree_spill. Screenshot results always include coordinate_width, coordinate_height, scale, and format, plus quality for jpeg; callers can request jpeg/quality for compression before resizing.",
571
598
  "inputSchema": {
572
599
  "$defs": {
573
600
  "ScreenshotOutputFormat": {
@@ -715,7 +742,7 @@ export const GENERATED_MCP_TOOLS =
715
742
  },
716
743
  "terminal_pid": {
717
744
  "default": null,
718
- "description": "Terminal emulator pid. Resolves a window target and scopes the tree when\npossible.",
745
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that). Resolves a window target and\nscopes the tree when possible.",
719
746
  "minimum": 0,
720
747
  "type": [
721
748
  "integer",
@@ -829,7 +856,7 @@ export const GENERATED_MCP_TOOLS =
829
856
  "openWorldHint": true,
830
857
  "readOnlyHint": false
831
858
  },
832
- "description": "Move a window to a new desktop position (frame top-left in desktop coordinates). Useful to recover windows that are partially off-screen. Works through the computer-use-linux GNOME Shell extension or a generic X11/EWMH window manager (wmctrl). Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
859
+ "description": "Move a window to a new desktop position (frame top-left in desktop coordinates). Useful to recover windows that are partially off-screen. Works only through the computer-use-linux GNOME Shell extension or a generic X11/EWMH window manager (wmctrl); other window backends refuse it. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
833
860
  "inputSchema": {
834
861
  "$defs": {
835
862
  "ScreenshotOutputFormat": {
@@ -844,6 +871,7 @@ export const GENERATED_MCP_TOOLS =
844
871
  "properties": {
845
872
  "app_id": {
846
873
  "default": null,
874
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment outside a terminal match. A segment that matches several apps is\nrejected.",
847
875
  "type": [
848
876
  "string",
849
877
  "null"
@@ -861,7 +889,7 @@ export const GENERATED_MCP_TOOLS =
861
889
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
862
890
  },
863
891
  "include_tree": {
864
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
892
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
865
893
  "type": [
866
894
  "boolean",
867
895
  "null"
@@ -893,6 +921,7 @@ export const GENERATED_MCP_TOOLS =
893
921
  },
894
922
  "pid": {
895
923
  "default": null,
924
+ "description": "Process id. It must match exactly one window.",
896
925
  "minimum": 0,
897
926
  "type": [
898
927
  "integer",
@@ -936,6 +965,7 @@ export const GENERATED_MCP_TOOLS =
936
965
  },
937
966
  "terminal_command": {
938
967
  "default": null,
968
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
939
969
  "type": [
940
970
  "string",
941
971
  "null"
@@ -943,6 +973,7 @@ export const GENERATED_MCP_TOOLS =
943
973
  },
944
974
  "terminal_cwd": {
945
975
  "default": null,
976
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
946
977
  "type": [
947
978
  "string",
948
979
  "null"
@@ -950,6 +981,7 @@ export const GENERATED_MCP_TOOLS =
950
981
  },
951
982
  "terminal_pid": {
952
983
  "default": null,
984
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
953
985
  "minimum": 0,
954
986
  "type": [
955
987
  "integer",
@@ -958,6 +990,7 @@ export const GENERATED_MCP_TOOLS =
958
990
  },
959
991
  "title": {
960
992
  "default": null,
993
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
961
994
  "type": [
962
995
  "string",
963
996
  "null"
@@ -965,6 +998,7 @@ export const GENERATED_MCP_TOOLS =
965
998
  },
966
999
  "tty": {
967
1000
  "default": null,
1001
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
968
1002
  "type": [
969
1003
  "string",
970
1004
  "null"
@@ -972,6 +1006,7 @@ export const GENERATED_MCP_TOOLS =
972
1006
  },
973
1007
  "window_id": {
974
1008
  "default": null,
1009
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, terminal fields, pid, app_id,\nwm_class, title. With a terminal field, pid, app_id, wm_class and title\nonly narrow the terminal match, which must name one window.",
975
1010
  "maximum": 9007199254740991,
976
1011
  "minimum": 0,
977
1012
  "type": [
@@ -981,6 +1016,7 @@ export const GENERATED_MCP_TOOLS =
981
1016
  },
982
1017
  "wm_class": {
983
1018
  "default": null,
1019
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
984
1020
  "type": [
985
1021
  "string",
986
1022
  "null"
@@ -1027,6 +1063,7 @@ export const GENERATED_MCP_TOOLS =
1027
1063
  "properties": {
1028
1064
  "action": {
1029
1065
  "default": null,
1066
+ "description": "AT-SPI action to invoke: its name or description, ignoring ASCII case,\nor its 0-based index. Default: the element's first action.",
1030
1067
  "type": [
1031
1068
  "string",
1032
1069
  "null"
@@ -1034,6 +1071,7 @@ export const GENERATED_MCP_TOOLS =
1034
1071
  },
1035
1072
  "app_id": {
1036
1073
  "default": null,
1074
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment. A segment that matches several apps is\nrejected.",
1037
1075
  "type": [
1038
1076
  "string",
1039
1077
  "null"
@@ -1041,6 +1079,7 @@ export const GENERATED_MCP_TOOLS =
1041
1079
  },
1042
1080
  "element_identifier": {
1043
1081
  "default": null,
1082
+ "description": "A node's object_ref from get_app_state or get_tree_page. It names the\nAT-SPI object itself, not a snapshot index, and wins over element_index\nand the selectors.",
1044
1083
  "type": [
1045
1084
  "string",
1046
1085
  "null"
@@ -1048,6 +1087,7 @@ export const GENERATED_MCP_TOOLS =
1048
1087
  },
1049
1088
  "element_index": {
1050
1089
  "default": null,
1090
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
1051
1091
  "minimum": 0,
1052
1092
  "type": [
1053
1093
  "integer",
@@ -1066,7 +1106,7 @@ export const GENERATED_MCP_TOOLS =
1066
1106
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1067
1107
  },
1068
1108
  "include_tree": {
1069
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1109
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
1070
1110
  "type": [
1071
1111
  "boolean",
1072
1112
  "null"
@@ -1098,6 +1138,7 @@ export const GENERATED_MCP_TOOLS =
1098
1138
  },
1099
1139
  "name": {
1100
1140
  "default": null,
1141
+ "description": "Case-insensitive substring of the element's accessible name.",
1101
1142
  "type": [
1102
1143
  "string",
1103
1144
  "null"
@@ -1105,6 +1146,7 @@ export const GENERATED_MCP_TOOLS =
1105
1146
  },
1106
1147
  "pid": {
1107
1148
  "default": null,
1149
+ "description": "Process id of the target app.",
1108
1150
  "minimum": 0,
1109
1151
  "type": [
1110
1152
  "integer",
@@ -1122,6 +1164,7 @@ export const GENERATED_MCP_TOOLS =
1122
1164
  },
1123
1165
  "role": {
1124
1166
  "default": null,
1167
+ "description": "Case-insensitive substring of the element's AT-SPI role.",
1125
1168
  "type": [
1126
1169
  "string",
1127
1170
  "null"
@@ -1155,6 +1198,7 @@ export const GENERATED_MCP_TOOLS =
1155
1198
  },
1156
1199
  "states": {
1157
1200
  "default": [],
1201
+ "description": "AT-SPI states the element must all have, case-insensitive (for\nexample focused, checked).",
1158
1202
  "items": {
1159
1203
  "type": "string"
1160
1204
  },
@@ -1162,6 +1206,7 @@ export const GENERATED_MCP_TOOLS =
1162
1206
  },
1163
1207
  "text": {
1164
1208
  "default": null,
1209
+ "description": "Case-insensitive substring of the element's text, name or description.",
1165
1210
  "type": [
1166
1211
  "string",
1167
1212
  "null"
@@ -1169,6 +1214,7 @@ export const GENERATED_MCP_TOOLS =
1169
1214
  },
1170
1215
  "window_id": {
1171
1216
  "default": null,
1217
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, pid, app_id, wm_class, window_title.",
1172
1218
  "maximum": 9007199254740991,
1173
1219
  "minimum": 0,
1174
1220
  "type": [
@@ -1178,6 +1224,7 @@ export const GENERATED_MCP_TOOLS =
1178
1224
  },
1179
1225
  "window_title": {
1180
1226
  "default": null,
1227
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch, the first wins.\nThis tool names the field window_title; a title field is ignored.",
1181
1228
  "type": [
1182
1229
  "string",
1183
1230
  "null"
@@ -1185,6 +1232,7 @@ export const GENERATED_MCP_TOOLS =
1185
1232
  },
1186
1233
  "wm_class": {
1187
1234
  "default": null,
1235
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
1188
1236
  "type": [
1189
1237
  "string",
1190
1238
  "null"
@@ -1202,7 +1250,7 @@ export const GENERATED_MCP_TOOLS =
1202
1250
  "openWorldHint": true,
1203
1251
  "readOnlyHint": false
1204
1252
  },
1205
- "description": "Press a key or key-combination on the keyboard, optionally after focusing a target window or terminal selector. Key grammar (case-insensitive; hyphens/spaces ignored): combos join with '+', e.g. Ctrl+L or Ctrl+Shift+T. Modifiers: ctrl/control, alt/option, shift, meta/super/cmd/command. Named keys: enter/return, escape/esc, tab, backspace, delete/del, space, home, end, pageup, pagedown, arrowleft/left, arrowright/right, arrowup/up, arrowdown/down, f1-f12. Plus single US letters a-z and digits 0-9. Anything else returns an error (never silently dropped). On Wayland, chords are sent through an active remote desktop portal keyboard session when one is available (or when ydotool is absent), falling back to ydotool otherwise. When ydotool is absent and the session has no RemoteDesktop portal (for example wlroots compositors), chords go through wtype instead. Portal chords send modifiers and named keys as keysyms so remapped keys (e.g. Caps Lock swapped with Control) follow the active keymap; letters and digits are physical US positions. Note: compositor-level shortcuts (e.g. Super+Up) may be consumed by GNOME before reaching the app. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
1253
+ "description": "Press a key or key-combination on the keyboard, optionally after focusing a target window or terminal selector. Key grammar (case-insensitive; hyphens/spaces ignored): combos join with '+', e.g. Ctrl+L or Ctrl+Shift+T. Modifiers: ctrl/control, alt/option, shift, meta/super/cmd/command. Named keys: enter/return, escape/esc, tab, backspace, delete/del, space, home, end, pageup, pagedown, arrowleft/left, arrowright/right, arrowup/up, arrowdown/down, f1-f12. Plus single US letters a-z and digits 0-9. Anything else returns an error (never silently dropped). On X11, chords go through xdotool (XTEST), or ydotool when xdotool is missing or cannot start. On Wayland, chords are sent through an active remote desktop portal keyboard session when one is available (or when ydotool is absent), falling back to ydotool otherwise. When ydotool is absent and the session has no RemoteDesktop portal (for example wlroots compositors), chords go through wtype instead. Portal chords send modifiers and named keys as keysyms so remapped keys (e.g. Caps Lock swapped with Control) follow the active keymap; letters and digits are physical US positions. On KDE Plasma every key in a portal chord is a physical keycode. Note: compositor-level shortcuts (e.g. Super+Up) may be consumed by GNOME before reaching the app. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
1206
1254
  "inputSchema": {
1207
1255
  "$defs": {
1208
1256
  "ScreenshotOutputFormat": {
@@ -1217,6 +1265,7 @@ export const GENERATED_MCP_TOOLS =
1217
1265
  "properties": {
1218
1266
  "app_id": {
1219
1267
  "default": null,
1268
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment outside a terminal match. A segment that matches several apps is\nrejected.",
1220
1269
  "type": [
1221
1270
  "string",
1222
1271
  "null"
@@ -1234,13 +1283,14 @@ export const GENERATED_MCP_TOOLS =
1234
1283
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1235
1284
  },
1236
1285
  "include_tree": {
1237
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1286
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
1238
1287
  "type": [
1239
1288
  "boolean",
1240
1289
  "null"
1241
1290
  ]
1242
1291
  },
1243
1292
  "key": {
1293
+ "description": "Key or chord in the grammar the tool description gives, for example\nEnter or Ctrl+Shift+T.",
1244
1294
  "type": "string"
1245
1295
  },
1246
1296
  "max_bytes": {
@@ -1269,6 +1319,7 @@ export const GENERATED_MCP_TOOLS =
1269
1319
  },
1270
1320
  "pid": {
1271
1321
  "default": null,
1322
+ "description": "Process id. It must match exactly one window.",
1272
1323
  "minimum": 0,
1273
1324
  "type": [
1274
1325
  "integer",
@@ -1312,6 +1363,7 @@ export const GENERATED_MCP_TOOLS =
1312
1363
  },
1313
1364
  "terminal_command": {
1314
1365
  "default": null,
1366
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
1315
1367
  "type": [
1316
1368
  "string",
1317
1369
  "null"
@@ -1319,6 +1371,7 @@ export const GENERATED_MCP_TOOLS =
1319
1371
  },
1320
1372
  "terminal_cwd": {
1321
1373
  "default": null,
1374
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
1322
1375
  "type": [
1323
1376
  "string",
1324
1377
  "null"
@@ -1326,6 +1379,7 @@ export const GENERATED_MCP_TOOLS =
1326
1379
  },
1327
1380
  "terminal_pid": {
1328
1381
  "default": null,
1382
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
1329
1383
  "minimum": 0,
1330
1384
  "type": [
1331
1385
  "integer",
@@ -1334,6 +1388,7 @@ export const GENERATED_MCP_TOOLS =
1334
1388
  },
1335
1389
  "title": {
1336
1390
  "default": null,
1391
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
1337
1392
  "type": [
1338
1393
  "string",
1339
1394
  "null"
@@ -1341,6 +1396,7 @@ export const GENERATED_MCP_TOOLS =
1341
1396
  },
1342
1397
  "tty": {
1343
1398
  "default": null,
1399
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
1344
1400
  "type": [
1345
1401
  "string",
1346
1402
  "null"
@@ -1348,6 +1404,7 @@ export const GENERATED_MCP_TOOLS =
1348
1404
  },
1349
1405
  "window_id": {
1350
1406
  "default": null,
1407
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, terminal fields, pid, app_id,\nwm_class, title. With a terminal field, pid, app_id, wm_class and title\nonly narrow the terminal match, which must name one window.",
1351
1408
  "maximum": 9007199254740991,
1352
1409
  "minimum": 0,
1353
1410
  "type": [
@@ -1357,6 +1414,7 @@ export const GENERATED_MCP_TOOLS =
1357
1414
  },
1358
1415
  "wm_class": {
1359
1416
  "default": null,
1417
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
1360
1418
  "type": [
1361
1419
  "string",
1362
1420
  "null"
@@ -1377,7 +1435,7 @@ export const GENERATED_MCP_TOOLS =
1377
1435
  "openWorldHint": true,
1378
1436
  "readOnlyHint": false
1379
1437
  },
1380
- "description": "Resize a window to a new frame width/height in desktop pixels, unmaximizing it first if needed. Useful to fit a window fully on-screen. Works through the computer-use-linux GNOME Shell extension or a generic X11/EWMH window manager (wmctrl). Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
1438
+ "description": "Resize a window in desktop pixels, unmaximizing it first if needed. Useful to fit a window fully on-screen. Through the computer-use-linux GNOME Shell extension, width and height set the frame; through a generic X11/EWMH window manager (wmctrl), they set the client area, and decorations add to it. Other window backends refuse it. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
1381
1439
  "inputSchema": {
1382
1440
  "$defs": {
1383
1441
  "ScreenshotOutputFormat": {
@@ -1392,6 +1450,7 @@ export const GENERATED_MCP_TOOLS =
1392
1450
  "properties": {
1393
1451
  "app_id": {
1394
1452
  "default": null,
1453
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment outside a terminal match. A segment that matches several apps is\nrejected.",
1395
1454
  "type": [
1396
1455
  "string",
1397
1456
  "null"
@@ -1409,12 +1468,12 @@ export const GENERATED_MCP_TOOLS =
1409
1468
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1410
1469
  },
1411
1470
  "height": {
1412
- "description": "New frame height in desktop pixels.",
1471
+ "description": "New height in desktop pixels: the frame through the GNOME Shell\nextension, the client area on X11/EWMH.",
1413
1472
  "format": "int32",
1414
1473
  "type": "integer"
1415
1474
  },
1416
1475
  "include_tree": {
1417
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1476
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
1418
1477
  "type": [
1419
1478
  "boolean",
1420
1479
  "null"
@@ -1446,6 +1505,7 @@ export const GENERATED_MCP_TOOLS =
1446
1505
  },
1447
1506
  "pid": {
1448
1507
  "default": null,
1508
+ "description": "Process id. It must match exactly one window.",
1449
1509
  "minimum": 0,
1450
1510
  "type": [
1451
1511
  "integer",
@@ -1489,6 +1549,7 @@ export const GENERATED_MCP_TOOLS =
1489
1549
  },
1490
1550
  "terminal_command": {
1491
1551
  "default": null,
1552
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
1492
1553
  "type": [
1493
1554
  "string",
1494
1555
  "null"
@@ -1496,6 +1557,7 @@ export const GENERATED_MCP_TOOLS =
1496
1557
  },
1497
1558
  "terminal_cwd": {
1498
1559
  "default": null,
1560
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
1499
1561
  "type": [
1500
1562
  "string",
1501
1563
  "null"
@@ -1503,6 +1565,7 @@ export const GENERATED_MCP_TOOLS =
1503
1565
  },
1504
1566
  "terminal_pid": {
1505
1567
  "default": null,
1568
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
1506
1569
  "minimum": 0,
1507
1570
  "type": [
1508
1571
  "integer",
@@ -1511,6 +1574,7 @@ export const GENERATED_MCP_TOOLS =
1511
1574
  },
1512
1575
  "title": {
1513
1576
  "default": null,
1577
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
1514
1578
  "type": [
1515
1579
  "string",
1516
1580
  "null"
@@ -1518,18 +1582,20 @@ export const GENERATED_MCP_TOOLS =
1518
1582
  },
1519
1583
  "tty": {
1520
1584
  "default": null,
1585
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
1521
1586
  "type": [
1522
1587
  "string",
1523
1588
  "null"
1524
1589
  ]
1525
1590
  },
1526
1591
  "width": {
1527
- "description": "New frame width in desktop pixels.",
1592
+ "description": "New width in desktop pixels: the frame through the GNOME Shell\nextension, the client area on X11/EWMH.",
1528
1593
  "format": "int32",
1529
1594
  "type": "integer"
1530
1595
  },
1531
1596
  "window_id": {
1532
1597
  "default": null,
1598
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, terminal fields, pid, app_id,\nwm_class, title. With a terminal field, pid, app_id, wm_class and title\nonly narrow the terminal match, which must name one window.",
1533
1599
  "maximum": 9007199254740991,
1534
1600
  "minimum": 0,
1535
1601
  "type": [
@@ -1539,6 +1605,7 @@ export const GENERATED_MCP_TOOLS =
1539
1605
  },
1540
1606
  "wm_class": {
1541
1607
  "default": null,
1608
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
1542
1609
  "type": [
1543
1610
  "string",
1544
1611
  "null"
@@ -1560,7 +1627,7 @@ export const GENERATED_MCP_TOOLS =
1560
1627
  "openWorldHint": true,
1561
1628
  "readOnlyHint": false
1562
1629
  },
1563
- "description": "Capture the screen and return it as a viewable, size-bounded image. Optionally target a window (window_id/pid/wm_class/title/app_id): the window is raised to the front and the image is cropped before any resize. Returns the image plus a short caption with returned dimensions, coordinate dimensions, scale, format, quality, source, and crop bounds; callers can request jpeg/quality for compression before resizing.",
1630
+ "description": "Capture the screen and return it as a viewable, size-bounded image. Optionally target a window (window_id/pid/wm_class/title/app_id): the window is raised to the front and the image is cropped before any resize; outside Hyprland background mode, a target without known bounds is refused, so pass full_screen=true there. Returns the image plus a JSON caption with returned and coordinate dimensions, scale, format, quality, source, cropped_to_window, and window_title. The crop origin is not reported; use relative=true on click or scroll for window-relative input. Callers can request jpeg/quality for compression before resizing.",
1564
1631
  "inputSchema": {
1565
1632
  "$defs": {
1566
1633
  "ScreenshotOutputFormat": {
@@ -1575,6 +1642,7 @@ export const GENERATED_MCP_TOOLS =
1575
1642
  "properties": {
1576
1643
  "app_id": {
1577
1644
  "default": null,
1645
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment. A segment that matches several apps is\nrejected.",
1578
1646
  "type": [
1579
1647
  "string",
1580
1648
  "null"
@@ -1629,6 +1697,7 @@ export const GENERATED_MCP_TOOLS =
1629
1697
  },
1630
1698
  "pid": {
1631
1699
  "default": null,
1700
+ "description": "Process id. It must match exactly one window.",
1632
1701
  "minimum": 0,
1633
1702
  "type": [
1634
1703
  "integer",
@@ -1664,6 +1733,7 @@ export const GENERATED_MCP_TOOLS =
1664
1733
  },
1665
1734
  "title": {
1666
1735
  "default": null,
1736
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch, the first wins.",
1667
1737
  "type": [
1668
1738
  "string",
1669
1739
  "null"
@@ -1671,6 +1741,7 @@ export const GENERATED_MCP_TOOLS =
1671
1741
  },
1672
1742
  "window_id": {
1673
1743
  "default": null,
1744
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, pid, app_id, wm_class, title.",
1674
1745
  "maximum": 9007199254740991,
1675
1746
  "minimum": 0,
1676
1747
  "type": [
@@ -1680,6 +1751,7 @@ export const GENERATED_MCP_TOOLS =
1680
1751
  },
1681
1752
  "wm_class": {
1682
1753
  "default": null,
1754
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
1683
1755
  "type": [
1684
1756
  "string",
1685
1757
  "null"
@@ -1697,7 +1769,7 @@ export const GENERATED_MCP_TOOLS =
1697
1769
  "openWorldHint": true,
1698
1770
  "readOnlyHint": false
1699
1771
  },
1700
- "description": "Scroll an element in a direction by a number of pages. With a window target and no x/y/element_index, scrolls at the centre of the targeted window. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
1772
+ "description": "Scroll an element, window, or point in a direction by a number of pages (5 wheel notches per page). With a window target and no x/y/element_index, scrolls at the centre of the targeted window; with no point or target, at the current pointer. A window target is raised and focused first; nothing is sent when focus cannot be verified. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
1701
1773
  "inputSchema": {
1702
1774
  "$defs": {
1703
1775
  "ScreenshotOutputFormat": {
@@ -1712,16 +1784,19 @@ export const GENERATED_MCP_TOOLS =
1712
1784
  "properties": {
1713
1785
  "app_id": {
1714
1786
  "default": null,
1787
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment. A segment that matches several apps is\nrejected.",
1715
1788
  "type": [
1716
1789
  "string",
1717
1790
  "null"
1718
1791
  ]
1719
1792
  },
1720
1793
  "direction": {
1794
+ "description": "up, down, left or right (case-insensitive).",
1721
1795
  "type": "string"
1722
1796
  },
1723
1797
  "element_index": {
1724
1798
  "default": null,
1799
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
1725
1800
  "minimum": 0,
1726
1801
  "type": [
1727
1802
  "integer",
@@ -1740,7 +1815,7 @@ export const GENERATED_MCP_TOOLS =
1740
1815
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1741
1816
  },
1742
1817
  "include_tree": {
1743
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1818
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
1744
1819
  "type": [
1745
1820
  "boolean",
1746
1821
  "null"
@@ -1772,6 +1847,7 @@ export const GENERATED_MCP_TOOLS =
1772
1847
  },
1773
1848
  "pages": {
1774
1849
  "default": null,
1850
+ "description": "Distance in pages (default 1), 5 wheel notches each. The sign is\nignored (direction sets it), and any value sends at least one notch.",
1775
1851
  "format": "double",
1776
1852
  "maximum": 100,
1777
1853
  "minimum": -100,
@@ -1782,6 +1858,7 @@ export const GENERATED_MCP_TOOLS =
1782
1858
  },
1783
1859
  "pid": {
1784
1860
  "default": null,
1861
+ "description": "Process id. It must match exactly one window.",
1785
1862
  "minimum": 0,
1786
1863
  "type": [
1787
1864
  "integer",
@@ -1833,6 +1910,7 @@ export const GENERATED_MCP_TOOLS =
1833
1910
  },
1834
1911
  "window_id": {
1835
1912
  "default": null,
1913
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, pid, app_id, wm_class, window_title.",
1836
1914
  "maximum": 9007199254740991,
1837
1915
  "minimum": 0,
1838
1916
  "type": [
@@ -1842,6 +1920,7 @@ export const GENERATED_MCP_TOOLS =
1842
1920
  },
1843
1921
  "window_title": {
1844
1922
  "default": null,
1923
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch, the first wins.\nThis tool names the field window_title; a title field is ignored.",
1845
1924
  "type": [
1846
1925
  "string",
1847
1926
  "null"
@@ -1849,6 +1928,7 @@ export const GENERATED_MCP_TOOLS =
1849
1928
  },
1850
1929
  "wm_class": {
1851
1930
  "default": null,
1931
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
1852
1932
  "type": [
1853
1933
  "string",
1854
1934
  "null"
@@ -1856,6 +1936,7 @@ export const GENERATED_MCP_TOOLS =
1856
1936
  },
1857
1937
  "x": {
1858
1938
  "default": null,
1939
+ "description": "Point x to scroll at in raw screenshot capture pixels: the coordinate_width and\ncoordinate_height space. Divide preview pixels by the screenshot scale\nfirst. With relative=true, measured from the window screenshot's crop origin.\nWithout x/y or element_index, the target window's centre, or the pointer.",
1859
1940
  "format": "int32",
1860
1941
  "type": [
1861
1942
  "integer",
@@ -1864,6 +1945,7 @@ export const GENERATED_MCP_TOOLS =
1864
1945
  },
1865
1946
  "y": {
1866
1947
  "default": null,
1948
+ "description": "Point y to scroll at in raw screenshot capture pixels: the coordinate_width and\ncoordinate_height space. Divide preview pixels by the screenshot scale\nfirst. With relative=true, measured from the window screenshot's crop origin.",
1867
1949
  "format": "int32",
1868
1950
  "type": [
1869
1951
  "integer",
@@ -1900,6 +1982,7 @@ export const GENERATED_MCP_TOOLS =
1900
1982
  "properties": {
1901
1983
  "app_id": {
1902
1984
  "default": null,
1985
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment. A segment that matches several apps is\nrejected.",
1903
1986
  "type": [
1904
1987
  "string",
1905
1988
  "null"
@@ -1907,6 +1990,7 @@ export const GENERATED_MCP_TOOLS =
1907
1990
  },
1908
1991
  "element_identifier": {
1909
1992
  "default": null,
1993
+ "description": "A node's object_ref from get_app_state or get_tree_page. It names the\nAT-SPI object itself, not a snapshot index, and wins over element_index\nand the selectors.",
1910
1994
  "type": [
1911
1995
  "string",
1912
1996
  "null"
@@ -1914,6 +1998,7 @@ export const GENERATED_MCP_TOOLS =
1914
1998
  },
1915
1999
  "element_index": {
1916
2000
  "default": null,
2001
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
1917
2002
  "minimum": 0,
1918
2003
  "type": [
1919
2004
  "integer",
@@ -1932,7 +2017,7 @@ export const GENERATED_MCP_TOOLS =
1932
2017
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1933
2018
  },
1934
2019
  "include_tree": {
1935
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
2020
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
1936
2021
  "type": [
1937
2022
  "boolean",
1938
2023
  "null"
@@ -1964,6 +2049,7 @@ export const GENERATED_MCP_TOOLS =
1964
2049
  },
1965
2050
  "name": {
1966
2051
  "default": null,
2052
+ "description": "Case-insensitive substring of the element's accessible name.",
1967
2053
  "type": [
1968
2054
  "string",
1969
2055
  "null"
@@ -1971,6 +2057,7 @@ export const GENERATED_MCP_TOOLS =
1971
2057
  },
1972
2058
  "pid": {
1973
2059
  "default": null,
2060
+ "description": "Process id of the target app.",
1974
2061
  "minimum": 0,
1975
2062
  "type": [
1976
2063
  "integer",
@@ -1988,6 +2075,7 @@ export const GENERATED_MCP_TOOLS =
1988
2075
  },
1989
2076
  "role": {
1990
2077
  "default": null,
2078
+ "description": "Case-insensitive substring of the element's AT-SPI role.",
1991
2079
  "type": [
1992
2080
  "string",
1993
2081
  "null"
@@ -2021,6 +2109,7 @@ export const GENERATED_MCP_TOOLS =
2021
2109
  },
2022
2110
  "states": {
2023
2111
  "default": [],
2112
+ "description": "AT-SPI states the element must all have, case-insensitive (for\nexample focused, checked).",
2024
2113
  "items": {
2025
2114
  "type": "string"
2026
2115
  },
@@ -2028,16 +2117,19 @@ export const GENERATED_MCP_TOOLS =
2028
2117
  },
2029
2118
  "text": {
2030
2119
  "default": null,
2120
+ "description": "Case-insensitive substring of the element's text, name or description.",
2031
2121
  "type": [
2032
2122
  "string",
2033
2123
  "null"
2034
2124
  ]
2035
2125
  },
2036
2126
  "value": {
2127
+ "description": "A number sets an element with the AT-SPI Value interface (slider, spin\nbutton). Otherwise the text replaces an editable text element's\ncontents. Text on a Value-only element is refused.",
2037
2128
  "type": "string"
2038
2129
  },
2039
2130
  "window_id": {
2040
2131
  "default": null,
2132
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, pid, app_id, wm_class, window_title.",
2041
2133
  "maximum": 9007199254740991,
2042
2134
  "minimum": 0,
2043
2135
  "type": [
@@ -2047,6 +2139,7 @@ export const GENERATED_MCP_TOOLS =
2047
2139
  },
2048
2140
  "window_title": {
2049
2141
  "default": null,
2142
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch, the first wins.\nThis tool names the field window_title; a title field is ignored.",
2050
2143
  "type": [
2051
2144
  "string",
2052
2145
  "null"
@@ -2054,6 +2147,7 @@ export const GENERATED_MCP_TOOLS =
2054
2147
  },
2055
2148
  "wm_class": {
2056
2149
  "default": null,
2150
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
2057
2151
  "type": [
2058
2152
  "string",
2059
2153
  "null"
@@ -2074,7 +2168,7 @@ export const GENERATED_MCP_TOOLS =
2074
2168
  "openWorldHint": false,
2075
2169
  "readOnlyHint": false
2076
2170
  },
2077
- "description": "Enable GNOME accessibility through gsettings so Linux Computer Use can read AT-SPI trees.",
2171
+ "description": "Enable GNOME accessibility so Linux Computer Use can read AT-SPI trees: sets and reads back the toolkit-accessibility gsettings key when it is not already true, and requests runtime org.a11y.Status IsEnabled when the tree cannot be built or the key does not read back.",
2078
2172
  "inputSchema": {
2079
2173
  "properties": {},
2080
2174
  "type": "object"
@@ -2088,7 +2182,7 @@ export const GENERATED_MCP_TOOLS =
2088
2182
  "openWorldHint": false,
2089
2183
  "readOnlyHint": false
2090
2184
  },
2091
- "description": "Install and enable the optional GNOME Shell extension used for exact window list/focus targeting when GNOME blocks native introspection.",
2185
+ "description": "Install and enable the bundled GNOME Shell extension. GNOME Wayland needs it for exact window focus, move_window and resize_window, since Introspect cannot focus, move or resize windows (and recent GNOME blocks its window list too); every GNOME session needs it for the on-screen indicator. Ask the user to log out and back in when the result says a shell reload is required.",
2092
2186
  "inputSchema": {
2093
2187
  "properties": {},
2094
2188
  "type": "object"
@@ -2102,7 +2196,7 @@ export const GENERATED_MCP_TOOLS =
2102
2196
  "openWorldHint": true,
2103
2197
  "readOnlyHint": false
2104
2198
  },
2105
- "description": "Type literal text using keyboard input, optionally after focusing a target window or terminal selector. Success confirms dispatch, not field-content verification; re-observe the target before retrying. X11 xdotool can silently substitute symbols under non-US or changing XKB layouts; inspect the text before pressing Enter or submitting it. The wtype backend rejects NUL and text over 131071 UTF-8 bytes before focus or indicators; Hyprland rejects confirmed password fields; ambiguous fields and terminals use private stdin for at most 100 Unicode characters per call. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
2199
+ "description": "Type literal text using keyboard input, optionally after focusing a target window or terminal selector. Success confirms dispatch, not field-content verification; re-observe the target before retrying. X11 xdotool can silently substitute symbols under non-US or changing XKB layouts; inspect the text before pressing Enter or submitting it. The wtype backend rejects NUL and text over 131071 UTF-8 bytes before focus or indicators. On Hyprland, confirmed password fields are rejected, and ambiguous fields and terminals use private stdin for at most 100 Unicode characters per call. Pass screenshot_after (true, \"screen\", or \"window\") or include_tree=true to return post-action observation in the same result.",
2106
2200
  "inputSchema": {
2107
2201
  "$defs": {
2108
2202
  "ScreenshotOutputFormat": {
@@ -2117,6 +2211,7 @@ export const GENERATED_MCP_TOOLS =
2117
2211
  "properties": {
2118
2212
  "app_id": {
2119
2213
  "default": null,
2214
+ "description": "Application id, ignoring ASCII case: the full desktop id, or its last\ndot-separated segment outside a terminal match. A segment that matches several apps is\nrejected.",
2120
2215
  "type": [
2121
2216
  "string",
2122
2217
  "null"
@@ -2134,7 +2229,7 @@ export const GENERATED_MCP_TOOLS =
2134
2229
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
2135
2230
  },
2136
2231
  "include_tree": {
2137
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
2232
+ "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.\nIt reads at most 1000 nodes and depth 32; when accessibility_tree_truncated\nis true, call get_app_state with a higher max_nodes.",
2138
2233
  "type": [
2139
2234
  "boolean",
2140
2235
  "null"
@@ -2166,6 +2261,7 @@ export const GENERATED_MCP_TOOLS =
2166
2261
  },
2167
2262
  "pid": {
2168
2263
  "default": null,
2264
+ "description": "Process id. It must match exactly one window.",
2169
2265
  "minimum": 0,
2170
2266
  "type": [
2171
2267
  "integer",
@@ -2209,6 +2305,7 @@ export const GENERATED_MCP_TOOLS =
2209
2305
  },
2210
2306
  "terminal_command": {
2211
2307
  "default": null,
2308
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
2212
2309
  "type": [
2213
2310
  "string",
2214
2311
  "null"
@@ -2216,6 +2313,7 @@ export const GENERATED_MCP_TOOLS =
2216
2313
  },
2217
2314
  "terminal_cwd": {
2218
2315
  "default": null,
2316
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
2219
2317
  "type": [
2220
2318
  "string",
2221
2319
  "null"
@@ -2223,6 +2321,7 @@ export const GENERATED_MCP_TOOLS =
2223
2321
  },
2224
2322
  "terminal_pid": {
2225
2323
  "default": null,
2324
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
2226
2325
  "minimum": 0,
2227
2326
  "type": [
2228
2327
  "integer",
@@ -2230,10 +2329,12 @@ export const GENERATED_MCP_TOOLS =
2230
2329
  ]
2231
2330
  },
2232
2331
  "text": {
2332
+ "description": "Literal text to type, sent as characters, not as key names.",
2233
2333
  "type": "string"
2234
2334
  },
2235
2335
  "title": {
2236
2336
  "default": null,
2337
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
2237
2338
  "type": [
2238
2339
  "string",
2239
2340
  "null"
@@ -2241,6 +2342,7 @@ export const GENERATED_MCP_TOOLS =
2241
2342
  },
2242
2343
  "tty": {
2243
2344
  "default": null,
2345
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
2244
2346
  "type": [
2245
2347
  "string",
2246
2348
  "null"
@@ -2248,6 +2350,7 @@ export const GENERATED_MCP_TOOLS =
2248
2350
  },
2249
2351
  "window_id": {
2250
2352
  "default": null,
2353
+ "description": "Window id from a recent list_windows. The first target field set\ndecides, in this order: window_id, terminal fields, pid, app_id,\nwm_class, title. With a terminal field, pid, app_id, wm_class and title\nonly narrow the terminal match, which must name one window.",
2251
2354
  "maximum": 9007199254740991,
2252
2355
  "minimum": 0,
2253
2356
  "type": [
@@ -2257,6 +2360,7 @@ export const GENERATED_MCP_TOOLS =
2257
2360
  },
2258
2361
  "wm_class": {
2259
2362
  "default": null,
2363
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
2260
2364
  "type": [
2261
2365
  "string",
2262
2366
  "null"