@agent-sh/computer-use-linux 0.7.42 → 0.7.44

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.42";
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.44";
11
+ export const GENERATED_TOOL_CATALOG_HASH = "dd4f0b26ce625940ae164e81508ce18b40a1062135346ec809ac2c97f5d62203";
12
+ export const GENERATED_SHELL_TOOL_CATALOG_HASH = "b4cb611f28a9653f5d6cde9dbf2b457e9afc40a4b1bb5102b988841c1b857672";
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"
@@ -429,7 +450,7 @@ export const GENERATED_MCP_TOOLS =
429
450
  "openWorldHint": true,
430
451
  "readOnlyHint": false
431
452
  },
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.",
453
+ "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
454
  "inputSchema": {
434
455
  "$defs": {
435
456
  "ScreenshotOutputFormat": {
@@ -462,7 +483,7 @@ export const GENERATED_MCP_TOOLS =
462
483
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
463
484
  },
464
485
  "include_tree": {
465
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
486
+ "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
487
  "type": [
467
488
  "boolean",
468
489
  "null"
@@ -567,7 +588,7 @@ export const GENERATED_MCP_TOOLS =
567
588
  "openWorldHint": true,
568
589
  "readOnlyHint": true
569
590
  },
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.",
591
+ "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
592
  "inputSchema": {
572
593
  "$defs": {
573
594
  "ScreenshotOutputFormat": {
@@ -715,7 +736,7 @@ export const GENERATED_MCP_TOOLS =
715
736
  },
716
737
  "terminal_pid": {
717
738
  "default": null,
718
- "description": "Terminal emulator pid. Resolves a window target and scopes the tree when\npossible.",
739
+ "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
740
  "minimum": 0,
720
741
  "type": [
721
742
  "integer",
@@ -829,7 +850,7 @@ export const GENERATED_MCP_TOOLS =
829
850
  "openWorldHint": true,
830
851
  "readOnlyHint": false
831
852
  },
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.",
853
+ "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
854
  "inputSchema": {
834
855
  "$defs": {
835
856
  "ScreenshotOutputFormat": {
@@ -844,6 +865,7 @@ export const GENERATED_MCP_TOOLS =
844
865
  "properties": {
845
866
  "app_id": {
846
867
  "default": null,
868
+ "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
869
  "type": [
848
870
  "string",
849
871
  "null"
@@ -861,7 +883,7 @@ export const GENERATED_MCP_TOOLS =
861
883
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
862
884
  },
863
885
  "include_tree": {
864
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
886
+ "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
887
  "type": [
866
888
  "boolean",
867
889
  "null"
@@ -893,6 +915,7 @@ export const GENERATED_MCP_TOOLS =
893
915
  },
894
916
  "pid": {
895
917
  "default": null,
918
+ "description": "Process id. It must match exactly one window.",
896
919
  "minimum": 0,
897
920
  "type": [
898
921
  "integer",
@@ -936,6 +959,7 @@ export const GENERATED_MCP_TOOLS =
936
959
  },
937
960
  "terminal_command": {
938
961
  "default": null,
962
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
939
963
  "type": [
940
964
  "string",
941
965
  "null"
@@ -943,6 +967,7 @@ export const GENERATED_MCP_TOOLS =
943
967
  },
944
968
  "terminal_cwd": {
945
969
  "default": null,
970
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
946
971
  "type": [
947
972
  "string",
948
973
  "null"
@@ -950,6 +975,7 @@ export const GENERATED_MCP_TOOLS =
950
975
  },
951
976
  "terminal_pid": {
952
977
  "default": null,
978
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
953
979
  "minimum": 0,
954
980
  "type": [
955
981
  "integer",
@@ -958,6 +984,7 @@ export const GENERATED_MCP_TOOLS =
958
984
  },
959
985
  "title": {
960
986
  "default": null,
987
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
961
988
  "type": [
962
989
  "string",
963
990
  "null"
@@ -965,6 +992,7 @@ export const GENERATED_MCP_TOOLS =
965
992
  },
966
993
  "tty": {
967
994
  "default": null,
995
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
968
996
  "type": [
969
997
  "string",
970
998
  "null"
@@ -972,6 +1000,7 @@ export const GENERATED_MCP_TOOLS =
972
1000
  },
973
1001
  "window_id": {
974
1002
  "default": null,
1003
+ "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
1004
  "maximum": 9007199254740991,
976
1005
  "minimum": 0,
977
1006
  "type": [
@@ -981,6 +1010,7 @@ export const GENERATED_MCP_TOOLS =
981
1010
  },
982
1011
  "wm_class": {
983
1012
  "default": null,
1013
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
984
1014
  "type": [
985
1015
  "string",
986
1016
  "null"
@@ -1034,6 +1064,7 @@ export const GENERATED_MCP_TOOLS =
1034
1064
  },
1035
1065
  "app_id": {
1036
1066
  "default": null,
1067
+ "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
1068
  "type": [
1038
1069
  "string",
1039
1070
  "null"
@@ -1048,6 +1079,7 @@ export const GENERATED_MCP_TOOLS =
1048
1079
  },
1049
1080
  "element_index": {
1050
1081
  "default": null,
1082
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
1051
1083
  "minimum": 0,
1052
1084
  "type": [
1053
1085
  "integer",
@@ -1066,7 +1098,7 @@ export const GENERATED_MCP_TOOLS =
1066
1098
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1067
1099
  },
1068
1100
  "include_tree": {
1069
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1101
+ "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
1102
  "type": [
1071
1103
  "boolean",
1072
1104
  "null"
@@ -1098,6 +1130,7 @@ export const GENERATED_MCP_TOOLS =
1098
1130
  },
1099
1131
  "name": {
1100
1132
  "default": null,
1133
+ "description": "Case-insensitive substring of the element's accessible name.",
1101
1134
  "type": [
1102
1135
  "string",
1103
1136
  "null"
@@ -1105,6 +1138,7 @@ export const GENERATED_MCP_TOOLS =
1105
1138
  },
1106
1139
  "pid": {
1107
1140
  "default": null,
1141
+ "description": "Process id of the target app.",
1108
1142
  "minimum": 0,
1109
1143
  "type": [
1110
1144
  "integer",
@@ -1122,6 +1156,7 @@ export const GENERATED_MCP_TOOLS =
1122
1156
  },
1123
1157
  "role": {
1124
1158
  "default": null,
1159
+ "description": "Case-insensitive substring of the element's AT-SPI role.",
1125
1160
  "type": [
1126
1161
  "string",
1127
1162
  "null"
@@ -1155,6 +1190,7 @@ export const GENERATED_MCP_TOOLS =
1155
1190
  },
1156
1191
  "states": {
1157
1192
  "default": [],
1193
+ "description": "AT-SPI states the element must all have, case-insensitive (for\nexample focused, checked).",
1158
1194
  "items": {
1159
1195
  "type": "string"
1160
1196
  },
@@ -1162,6 +1198,7 @@ export const GENERATED_MCP_TOOLS =
1162
1198
  },
1163
1199
  "text": {
1164
1200
  "default": null,
1201
+ "description": "Case-insensitive substring of the element's text, name or description.",
1165
1202
  "type": [
1166
1203
  "string",
1167
1204
  "null"
@@ -1169,6 +1206,7 @@ export const GENERATED_MCP_TOOLS =
1169
1206
  },
1170
1207
  "window_id": {
1171
1208
  "default": null,
1209
+ "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
1210
  "maximum": 9007199254740991,
1173
1211
  "minimum": 0,
1174
1212
  "type": [
@@ -1178,6 +1216,7 @@ export const GENERATED_MCP_TOOLS =
1178
1216
  },
1179
1217
  "window_title": {
1180
1218
  "default": null,
1219
+ "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
1220
  "type": [
1182
1221
  "string",
1183
1222
  "null"
@@ -1185,6 +1224,7 @@ export const GENERATED_MCP_TOOLS =
1185
1224
  },
1186
1225
  "wm_class": {
1187
1226
  "default": null,
1227
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
1188
1228
  "type": [
1189
1229
  "string",
1190
1230
  "null"
@@ -1202,7 +1242,7 @@ export const GENERATED_MCP_TOOLS =
1202
1242
  "openWorldHint": true,
1203
1243
  "readOnlyHint": false
1204
1244
  },
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.",
1245
+ "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
1246
  "inputSchema": {
1207
1247
  "$defs": {
1208
1248
  "ScreenshotOutputFormat": {
@@ -1217,6 +1257,7 @@ export const GENERATED_MCP_TOOLS =
1217
1257
  "properties": {
1218
1258
  "app_id": {
1219
1259
  "default": null,
1260
+ "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
1261
  "type": [
1221
1262
  "string",
1222
1263
  "null"
@@ -1234,13 +1275,14 @@ export const GENERATED_MCP_TOOLS =
1234
1275
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1235
1276
  },
1236
1277
  "include_tree": {
1237
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1278
+ "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
1279
  "type": [
1239
1280
  "boolean",
1240
1281
  "null"
1241
1282
  ]
1242
1283
  },
1243
1284
  "key": {
1285
+ "description": "Key or chord in the grammar the tool description gives, for example\nEnter or Ctrl+Shift+T.",
1244
1286
  "type": "string"
1245
1287
  },
1246
1288
  "max_bytes": {
@@ -1269,6 +1311,7 @@ export const GENERATED_MCP_TOOLS =
1269
1311
  },
1270
1312
  "pid": {
1271
1313
  "default": null,
1314
+ "description": "Process id. It must match exactly one window.",
1272
1315
  "minimum": 0,
1273
1316
  "type": [
1274
1317
  "integer",
@@ -1312,6 +1355,7 @@ export const GENERATED_MCP_TOOLS =
1312
1355
  },
1313
1356
  "terminal_command": {
1314
1357
  "default": null,
1358
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
1315
1359
  "type": [
1316
1360
  "string",
1317
1361
  "null"
@@ -1319,6 +1363,7 @@ export const GENERATED_MCP_TOOLS =
1319
1363
  },
1320
1364
  "terminal_cwd": {
1321
1365
  "default": null,
1366
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
1322
1367
  "type": [
1323
1368
  "string",
1324
1369
  "null"
@@ -1326,6 +1371,7 @@ export const GENERATED_MCP_TOOLS =
1326
1371
  },
1327
1372
  "terminal_pid": {
1328
1373
  "default": null,
1374
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
1329
1375
  "minimum": 0,
1330
1376
  "type": [
1331
1377
  "integer",
@@ -1334,6 +1380,7 @@ export const GENERATED_MCP_TOOLS =
1334
1380
  },
1335
1381
  "title": {
1336
1382
  "default": null,
1383
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
1337
1384
  "type": [
1338
1385
  "string",
1339
1386
  "null"
@@ -1341,6 +1388,7 @@ export const GENERATED_MCP_TOOLS =
1341
1388
  },
1342
1389
  "tty": {
1343
1390
  "default": null,
1391
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
1344
1392
  "type": [
1345
1393
  "string",
1346
1394
  "null"
@@ -1348,6 +1396,7 @@ export const GENERATED_MCP_TOOLS =
1348
1396
  },
1349
1397
  "window_id": {
1350
1398
  "default": null,
1399
+ "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
1400
  "maximum": 9007199254740991,
1352
1401
  "minimum": 0,
1353
1402
  "type": [
@@ -1357,6 +1406,7 @@ export const GENERATED_MCP_TOOLS =
1357
1406
  },
1358
1407
  "wm_class": {
1359
1408
  "default": null,
1409
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
1360
1410
  "type": [
1361
1411
  "string",
1362
1412
  "null"
@@ -1377,7 +1427,7 @@ export const GENERATED_MCP_TOOLS =
1377
1427
  "openWorldHint": true,
1378
1428
  "readOnlyHint": false
1379
1429
  },
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.",
1430
+ "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
1431
  "inputSchema": {
1382
1432
  "$defs": {
1383
1433
  "ScreenshotOutputFormat": {
@@ -1392,6 +1442,7 @@ export const GENERATED_MCP_TOOLS =
1392
1442
  "properties": {
1393
1443
  "app_id": {
1394
1444
  "default": null,
1445
+ "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
1446
  "type": [
1396
1447
  "string",
1397
1448
  "null"
@@ -1409,12 +1460,12 @@ export const GENERATED_MCP_TOOLS =
1409
1460
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1410
1461
  },
1411
1462
  "height": {
1412
- "description": "New frame height in desktop pixels.",
1463
+ "description": "New height in desktop pixels: the frame through the GNOME Shell\nextension, the client area on X11/EWMH.",
1413
1464
  "format": "int32",
1414
1465
  "type": "integer"
1415
1466
  },
1416
1467
  "include_tree": {
1417
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1468
+ "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
1469
  "type": [
1419
1470
  "boolean",
1420
1471
  "null"
@@ -1446,6 +1497,7 @@ export const GENERATED_MCP_TOOLS =
1446
1497
  },
1447
1498
  "pid": {
1448
1499
  "default": null,
1500
+ "description": "Process id. It must match exactly one window.",
1449
1501
  "minimum": 0,
1450
1502
  "type": [
1451
1503
  "integer",
@@ -1489,6 +1541,7 @@ export const GENERATED_MCP_TOOLS =
1489
1541
  },
1490
1542
  "terminal_command": {
1491
1543
  "default": null,
1544
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
1492
1545
  "type": [
1493
1546
  "string",
1494
1547
  "null"
@@ -1496,6 +1549,7 @@ export const GENERATED_MCP_TOOLS =
1496
1549
  },
1497
1550
  "terminal_cwd": {
1498
1551
  "default": null,
1552
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
1499
1553
  "type": [
1500
1554
  "string",
1501
1555
  "null"
@@ -1503,6 +1557,7 @@ export const GENERATED_MCP_TOOLS =
1503
1557
  },
1504
1558
  "terminal_pid": {
1505
1559
  "default": null,
1560
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
1506
1561
  "minimum": 0,
1507
1562
  "type": [
1508
1563
  "integer",
@@ -1511,6 +1566,7 @@ export const GENERATED_MCP_TOOLS =
1511
1566
  },
1512
1567
  "title": {
1513
1568
  "default": null,
1569
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
1514
1570
  "type": [
1515
1571
  "string",
1516
1572
  "null"
@@ -1518,18 +1574,20 @@ export const GENERATED_MCP_TOOLS =
1518
1574
  },
1519
1575
  "tty": {
1520
1576
  "default": null,
1577
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
1521
1578
  "type": [
1522
1579
  "string",
1523
1580
  "null"
1524
1581
  ]
1525
1582
  },
1526
1583
  "width": {
1527
- "description": "New frame width in desktop pixels.",
1584
+ "description": "New width in desktop pixels: the frame through the GNOME Shell\nextension, the client area on X11/EWMH.",
1528
1585
  "format": "int32",
1529
1586
  "type": "integer"
1530
1587
  },
1531
1588
  "window_id": {
1532
1589
  "default": null,
1590
+ "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
1591
  "maximum": 9007199254740991,
1534
1592
  "minimum": 0,
1535
1593
  "type": [
@@ -1539,6 +1597,7 @@ export const GENERATED_MCP_TOOLS =
1539
1597
  },
1540
1598
  "wm_class": {
1541
1599
  "default": null,
1600
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
1542
1601
  "type": [
1543
1602
  "string",
1544
1603
  "null"
@@ -1560,7 +1619,7 @@ export const GENERATED_MCP_TOOLS =
1560
1619
  "openWorldHint": true,
1561
1620
  "readOnlyHint": false
1562
1621
  },
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.",
1622
+ "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
1623
  "inputSchema": {
1565
1624
  "$defs": {
1566
1625
  "ScreenshotOutputFormat": {
@@ -1575,6 +1634,7 @@ export const GENERATED_MCP_TOOLS =
1575
1634
  "properties": {
1576
1635
  "app_id": {
1577
1636
  "default": null,
1637
+ "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
1638
  "type": [
1579
1639
  "string",
1580
1640
  "null"
@@ -1629,6 +1689,7 @@ export const GENERATED_MCP_TOOLS =
1629
1689
  },
1630
1690
  "pid": {
1631
1691
  "default": null,
1692
+ "description": "Process id. It must match exactly one window.",
1632
1693
  "minimum": 0,
1633
1694
  "type": [
1634
1695
  "integer",
@@ -1664,6 +1725,7 @@ export const GENERATED_MCP_TOOLS =
1664
1725
  },
1665
1726
  "title": {
1666
1727
  "default": null,
1728
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch, the first wins.",
1667
1729
  "type": [
1668
1730
  "string",
1669
1731
  "null"
@@ -1671,6 +1733,7 @@ export const GENERATED_MCP_TOOLS =
1671
1733
  },
1672
1734
  "window_id": {
1673
1735
  "default": null,
1736
+ "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
1737
  "maximum": 9007199254740991,
1675
1738
  "minimum": 0,
1676
1739
  "type": [
@@ -1680,6 +1743,7 @@ export const GENERATED_MCP_TOOLS =
1680
1743
  },
1681
1744
  "wm_class": {
1682
1745
  "default": null,
1746
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
1683
1747
  "type": [
1684
1748
  "string",
1685
1749
  "null"
@@ -1697,7 +1761,7 @@ export const GENERATED_MCP_TOOLS =
1697
1761
  "openWorldHint": true,
1698
1762
  "readOnlyHint": false
1699
1763
  },
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.",
1764
+ "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
1765
  "inputSchema": {
1702
1766
  "$defs": {
1703
1767
  "ScreenshotOutputFormat": {
@@ -1712,16 +1776,19 @@ export const GENERATED_MCP_TOOLS =
1712
1776
  "properties": {
1713
1777
  "app_id": {
1714
1778
  "default": null,
1779
+ "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
1780
  "type": [
1716
1781
  "string",
1717
1782
  "null"
1718
1783
  ]
1719
1784
  },
1720
1785
  "direction": {
1786
+ "description": "up, down, left or right (case-insensitive).",
1721
1787
  "type": "string"
1722
1788
  },
1723
1789
  "element_index": {
1724
1790
  "default": null,
1791
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
1725
1792
  "minimum": 0,
1726
1793
  "type": [
1727
1794
  "integer",
@@ -1740,7 +1807,7 @@ export const GENERATED_MCP_TOOLS =
1740
1807
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1741
1808
  },
1742
1809
  "include_tree": {
1743
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
1810
+ "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
1811
  "type": [
1745
1812
  "boolean",
1746
1813
  "null"
@@ -1772,6 +1839,7 @@ export const GENERATED_MCP_TOOLS =
1772
1839
  },
1773
1840
  "pages": {
1774
1841
  "default": null,
1842
+ "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
1843
  "format": "double",
1776
1844
  "maximum": 100,
1777
1845
  "minimum": -100,
@@ -1782,6 +1850,7 @@ export const GENERATED_MCP_TOOLS =
1782
1850
  },
1783
1851
  "pid": {
1784
1852
  "default": null,
1853
+ "description": "Process id. It must match exactly one window.",
1785
1854
  "minimum": 0,
1786
1855
  "type": [
1787
1856
  "integer",
@@ -1833,6 +1902,7 @@ export const GENERATED_MCP_TOOLS =
1833
1902
  },
1834
1903
  "window_id": {
1835
1904
  "default": null,
1905
+ "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
1906
  "maximum": 9007199254740991,
1837
1907
  "minimum": 0,
1838
1908
  "type": [
@@ -1842,6 +1912,7 @@ export const GENERATED_MCP_TOOLS =
1842
1912
  },
1843
1913
  "window_title": {
1844
1914
  "default": null,
1915
+ "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
1916
  "type": [
1846
1917
  "string",
1847
1918
  "null"
@@ -1849,6 +1920,7 @@ export const GENERATED_MCP_TOOLS =
1849
1920
  },
1850
1921
  "wm_class": {
1851
1922
  "default": null,
1923
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
1852
1924
  "type": [
1853
1925
  "string",
1854
1926
  "null"
@@ -1900,6 +1972,7 @@ export const GENERATED_MCP_TOOLS =
1900
1972
  "properties": {
1901
1973
  "app_id": {
1902
1974
  "default": null,
1975
+ "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
1976
  "type": [
1904
1977
  "string",
1905
1978
  "null"
@@ -1914,6 +1987,7 @@ export const GENERATED_MCP_TOOLS =
1914
1987
  },
1915
1988
  "element_index": {
1916
1989
  "default": null,
1990
+ "description": "Element index from the latest get_app_state or include_tree snapshot.",
1917
1991
  "minimum": 0,
1918
1992
  "type": [
1919
1993
  "integer",
@@ -1932,7 +2006,7 @@ export const GENERATED_MCP_TOOLS =
1932
2006
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
1933
2007
  },
1934
2008
  "include_tree": {
1935
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
2009
+ "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
2010
  "type": [
1937
2011
  "boolean",
1938
2012
  "null"
@@ -1964,6 +2038,7 @@ export const GENERATED_MCP_TOOLS =
1964
2038
  },
1965
2039
  "name": {
1966
2040
  "default": null,
2041
+ "description": "Case-insensitive substring of the element's accessible name.",
1967
2042
  "type": [
1968
2043
  "string",
1969
2044
  "null"
@@ -1971,6 +2046,7 @@ export const GENERATED_MCP_TOOLS =
1971
2046
  },
1972
2047
  "pid": {
1973
2048
  "default": null,
2049
+ "description": "Process id of the target app.",
1974
2050
  "minimum": 0,
1975
2051
  "type": [
1976
2052
  "integer",
@@ -1988,6 +2064,7 @@ export const GENERATED_MCP_TOOLS =
1988
2064
  },
1989
2065
  "role": {
1990
2066
  "default": null,
2067
+ "description": "Case-insensitive substring of the element's AT-SPI role.",
1991
2068
  "type": [
1992
2069
  "string",
1993
2070
  "null"
@@ -2021,6 +2098,7 @@ export const GENERATED_MCP_TOOLS =
2021
2098
  },
2022
2099
  "states": {
2023
2100
  "default": [],
2101
+ "description": "AT-SPI states the element must all have, case-insensitive (for\nexample focused, checked).",
2024
2102
  "items": {
2025
2103
  "type": "string"
2026
2104
  },
@@ -2028,6 +2106,7 @@ export const GENERATED_MCP_TOOLS =
2028
2106
  },
2029
2107
  "text": {
2030
2108
  "default": null,
2109
+ "description": "Case-insensitive substring of the element's text, name or description.",
2031
2110
  "type": [
2032
2111
  "string",
2033
2112
  "null"
@@ -2038,6 +2117,7 @@ export const GENERATED_MCP_TOOLS =
2038
2117
  },
2039
2118
  "window_id": {
2040
2119
  "default": null,
2120
+ "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
2121
  "maximum": 9007199254740991,
2042
2122
  "minimum": 0,
2043
2123
  "type": [
@@ -2047,6 +2127,7 @@ export const GENERATED_MCP_TOOLS =
2047
2127
  },
2048
2128
  "window_title": {
2049
2129
  "default": null,
2130
+ "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
2131
  "type": [
2051
2132
  "string",
2052
2133
  "null"
@@ -2054,6 +2135,7 @@ export const GENERATED_MCP_TOOLS =
2054
2135
  },
2055
2136
  "wm_class": {
2056
2137
  "default": null,
2138
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match, the first wins.",
2057
2139
  "type": [
2058
2140
  "string",
2059
2141
  "null"
@@ -2074,7 +2156,7 @@ export const GENERATED_MCP_TOOLS =
2074
2156
  "openWorldHint": false,
2075
2157
  "readOnlyHint": false
2076
2158
  },
2077
- "description": "Enable GNOME accessibility through gsettings so Linux Computer Use can read AT-SPI trees.",
2159
+ "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
2160
  "inputSchema": {
2079
2161
  "properties": {},
2080
2162
  "type": "object"
@@ -2088,7 +2170,7 @@ export const GENERATED_MCP_TOOLS =
2088
2170
  "openWorldHint": false,
2089
2171
  "readOnlyHint": false
2090
2172
  },
2091
- "description": "Install and enable the optional GNOME Shell extension used for exact window list/focus targeting when GNOME blocks native introspection.",
2173
+ "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
2174
  "inputSchema": {
2093
2175
  "properties": {},
2094
2176
  "type": "object"
@@ -2102,7 +2184,7 @@ export const GENERATED_MCP_TOOLS =
2102
2184
  "openWorldHint": true,
2103
2185
  "readOnlyHint": false
2104
2186
  },
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.",
2187
+ "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
2188
  "inputSchema": {
2107
2189
  "$defs": {
2108
2190
  "ScreenshotOutputFormat": {
@@ -2117,6 +2199,7 @@ export const GENERATED_MCP_TOOLS =
2117
2199
  "properties": {
2118
2200
  "app_id": {
2119
2201
  "default": null,
2202
+ "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
2203
  "type": [
2121
2204
  "string",
2122
2205
  "null"
@@ -2134,7 +2217,7 @@ export const GENERATED_MCP_TOOLS =
2134
2217
  "description": "Post-action screenshot image format (default png). Use jpeg with quality to trade exact pixels for smaller payloads."
2135
2218
  },
2136
2219
  "include_tree": {
2137
- "description": "Include a fresh compacted AT-SPI accessibility tree snapshot after the action (default false). Also refreshes cached element_index values.",
2220
+ "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
2221
  "type": [
2139
2222
  "boolean",
2140
2223
  "null"
@@ -2166,6 +2249,7 @@ export const GENERATED_MCP_TOOLS =
2166
2249
  },
2167
2250
  "pid": {
2168
2251
  "default": null,
2252
+ "description": "Process id. It must match exactly one window.",
2169
2253
  "minimum": 0,
2170
2254
  "type": [
2171
2255
  "integer",
@@ -2209,6 +2293,7 @@ export const GENERATED_MCP_TOOLS =
2209
2293
  },
2210
2294
  "terminal_command": {
2211
2295
  "default": null,
2296
+ "description": "Case-insensitive substring of the command name or command line of a\nterminal's shell or foreground process.",
2212
2297
  "type": [
2213
2298
  "string",
2214
2299
  "null"
@@ -2216,6 +2301,7 @@ export const GENERATED_MCP_TOOLS =
2216
2301
  },
2217
2302
  "terminal_cwd": {
2218
2303
  "default": null,
2304
+ "description": "Working directory of a terminal's shell or foreground process: an\nabsolute path, or a trailing path such as project/src.",
2219
2305
  "type": [
2220
2306
  "string",
2221
2307
  "null"
@@ -2223,6 +2309,7 @@ export const GENERATED_MCP_TOOLS =
2223
2309
  },
2224
2310
  "terminal_pid": {
2225
2311
  "default": null,
2312
+ "description": "Pid of the shell or foreground process on a terminal's tty, not the\nterminal emulator (use pid for that).",
2226
2313
  "minimum": 0,
2227
2314
  "type": [
2228
2315
  "integer",
@@ -2230,10 +2317,12 @@ export const GENERATED_MCP_TOOLS =
2230
2317
  ]
2231
2318
  },
2232
2319
  "text": {
2320
+ "description": "Literal text to type, sent as characters, not as key names.",
2233
2321
  "type": "string"
2234
2322
  },
2235
2323
  "title": {
2236
2324
  "default": null,
2325
+ "description": "Window title substring, ignoring ASCII case. When several windows\nmatch outside a terminal match, the first wins.",
2237
2326
  "type": [
2238
2327
  "string",
2239
2328
  "null"
@@ -2241,6 +2330,7 @@ export const GENERATED_MCP_TOOLS =
2241
2330
  },
2242
2331
  "tty": {
2243
2332
  "default": null,
2333
+ "description": "Terminal tty: /dev/pts/N, pts/N or N.",
2244
2334
  "type": [
2245
2335
  "string",
2246
2336
  "null"
@@ -2248,6 +2338,7 @@ export const GENERATED_MCP_TOOLS =
2248
2338
  },
2249
2339
  "window_id": {
2250
2340
  "default": null,
2341
+ "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
2342
  "maximum": 9007199254740991,
2252
2343
  "minimum": 0,
2253
2344
  "type": [
@@ -2257,6 +2348,7 @@ export const GENERATED_MCP_TOOLS =
2257
2348
  },
2258
2349
  "wm_class": {
2259
2350
  "default": null,
2351
+ "description": "Window manager class, an exact match ignoring ASCII case. When several\nwindows match outside a terminal match, the first wins.",
2260
2352
  "type": [
2261
2353
  "string",
2262
2354
  "null"