feat: Document punctuation key sequences

Stainless-Generated-From: 16c95773a23ee13f801cdb8e6685186475f077a0

Author: kernel-internal[bot]

src/kernel/resources/browsers/computer.py

@@ -397,7 +397,9 @@ def press_key(
           keys: List of key symbols to press. Each item should be a key symbol supported by
               xdotool (see X11 keysym definitions). Examples include "Return", "Shift",
               "Ctrl", "Alt", "F5". Items in this list could also be combinations, e.g.
-              "Ctrl+t" or "Ctrl+Shift+Tab".
+              "Ctrl+t" or "Ctrl+Shift+Tab". Use X11 names for punctuation in combinations,
+              such as "Ctrl+minus" or "Ctrl+plus". A literal hyphen is also accepted as an
+              alias, so "Ctrl+-" is normalized to "Ctrl+minus".
 
           duration: Duration to hold the keys down in milliseconds. If omitted or 0, keys are
               tapped.
@@ -1002,7 +1004,9 @@ async def press_key(
           keys: List of key symbols to press. Each item should be a key symbol supported by
               xdotool (see X11 keysym definitions). Examples include "Return", "Shift",
               "Ctrl", "Alt", "F5". Items in this list could also be combinations, e.g.
-              "Ctrl+t" or "Ctrl+Shift+Tab".
+              "Ctrl+t" or "Ctrl+Shift+Tab". Use X11 names for punctuation in combinations,
+              such as "Ctrl+minus" or "Ctrl+plus". A literal hyphen is also accepted as an
+              alias, so "Ctrl+-" is normalized to "Ctrl+minus".
 
           duration: Duration to hold the keys down in milliseconds. If omitted or 0, keys are
               tapped.

src/kernel/types/browsers/computer_batch_params.py

@@ -110,7 +110,10 @@ class ActionPressKey(TypedDict, total=False):
 
     Each item should be a key symbol supported by xdotool (see X11 keysym
     definitions). Examples include "Return", "Shift", "Ctrl", "Alt", "F5". Items in
-    this list could also be combinations, e.g. "Ctrl+t" or "Ctrl+Shift+Tab".
+    this list could also be combinations, e.g. "Ctrl+t" or "Ctrl+Shift+Tab". Use X11
+    names for punctuation in combinations, such as "Ctrl+minus" or "Ctrl+plus". A
+    literal hyphen is also accepted as an alias, so "Ctrl+-" is normalized to
+    "Ctrl+minus".
     """
 
     duration: int

src/kernel/types/browsers/computer_press_key_params.py

@@ -15,7 +15,10 @@ class ComputerPressKeyParams(TypedDict, total=False):
 
     Each item should be a key symbol supported by xdotool (see X11 keysym
     definitions). Examples include "Return", "Shift", "Ctrl", "Alt", "F5". Items in
-    this list could also be combinations, e.g. "Ctrl+t" or "Ctrl+Shift+Tab".
+    this list could also be combinations, e.g. "Ctrl+t" or "Ctrl+Shift+Tab". Use X11
+    names for punctuation in combinations, such as "Ctrl+minus" or "Ctrl+plus". A
+    literal hyphen is also accepted as an alias, so "Ctrl+-" is normalized to
+    "Ctrl+minus".
     """
 
     duration: int