[Bug] WindowsACI.hotkey() splits key names into individual characters

[vra1974]

Bug Description

When calling WindowsACI.hotkey() with a key name like 'enter', the method incorrectly splits the key name into individual characters instead of treating it as a single key.

Steps to Reproduce

python from gui_agents.aci.WindowsOSACI import WindowsACI aci = WindowsACI() print(aci.hotkey('enter'))

Expected Output

python "import pyautogui; pyautogui.hotkey('enter', interval=0.5)"

Actual Output

python "import pyautogui; pyautogui.hotkey('e', 'n', 't', 'e', 'r', interval=0.5)"

This causes the characters 'e', 'n', 't', 'e', 'r' to be typed instead of pressing the Enter key.

Workaround

Use pyautogui.hotkey() directly instead of the ACI method:

python import pyautogui pyautogui.hotkey('enter') # Works correctly pyautogui.hotkey('alt', 'tab') # Also works

Environment

• OS: Windows 10
• Python: 3.13
• gui-agents version: latest from pip

[iamprakashs]

Hi! I've identified the root cause and submitted a fix for this issue.

Root Cause: When a string like 'enter' is passed to hotkey(), Python iterates over the string characters, splitting it into ['e', 'n', 't', 'e', 'r'].

Fix: Added a type check to wrap strings in a list before processing.

Tests: Added comprehensive unit tests covering:

• Single key as string ('enter')
• Single key as list (['enter'])
• Multiple keys (['alt', 'tab'])
• Control key normalization
• Regression test to ensure strings aren't split

PR incoming! 🚀