oagi-core 0.13.2__tar.gz → 0.14.1__tar.gz

{oagi_core-0.13.2 → oagi_core-0.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.13.2
+Version: 0.14.1
 Summary: Official API of OpenAGI Foundation
 Project-URL: Homepage, https://github.com/agiopen-org/oagi
 Author-email: OpenAGI Foundation <contact@agiopen.org>
@@ -31,6 +31,7 @@ Requires-Dist: openai>=1.3.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=10.0.0
 Provides-Extra: desktop
+Requires-Dist: mss>=9.0.0; (sys_platform == 'win32') and extra == 'desktop'
 Requires-Dist: pillow>=9.0.0; extra == 'desktop'
 Requires-Dist: pyautogui>=0.9.54; extra == 'desktop'
 Requires-Dist: pyobjc-framework-applicationservices>=8.0; (sys_platform == 'darwin') and extra == 'desktop'
@@ -153,12 +154,15 @@ from oagi import AsyncPyautoguiActionHandler, PyautoguiConfig
 
 # Customize action behavior
 config = PyautoguiConfig(
-    drag_duration=1.0,      # Slower drags for precision (default: 0.5)
-    scroll_amount=50,       # Larger scroll steps (default: 30)
-    wait_duration=2.0,      # Longer waits (default: 1.0)
-    action_pause=0.2,       # More pause between actions (default: 0.1)
-    hotkey_interval=0.1,    # Interval between keys in hotkey combinations (default: 0.1)
-    capslock_mode="session" # Caps lock mode: 'session' or 'system' (default: 'session')
+    drag_duration=1.0,       # Slower drags for precision (default: 0.5)
+    scroll_amount=50,        # Larger scroll steps (default: 2 on macOS, 100 on others)
+    wait_duration=2.0,       # Longer waits for WAIT action (default: 1.0)
+    action_pause=0.2,        # Pause between PyAutoGUI calls (default: 0.1)
+    hotkey_interval=0.1,     # Interval between keys in hotkey combos (default: 0.1)
+    capslock_mode="session", # Caps lock mode: 'session' or 'system' (default: 'session')
+    macos_ctrl_to_cmd=True,  # Replace ctrl with cmd on macOS (default: True)
+    click_pre_delay=0.1,     # Delay after move before click (default: 0.1)
+    post_batch_delay=1.0,    # Delay after actions before next screenshot (default: 1.0)
 )
 
 action_handler = AsyncPyautoguiActionHandler(config=config)
@@ -184,8 +188,14 @@ oagi agent modes
 # Check macOS permissions (screen recording & accessibility)
 oagi agent permission
 
+# Print all available screens and their indices
+oagi agent screens
+
 # Export execution history
 oagi agent run "Complete the form" --export html --export-file report.html
+
+# Run with a specific screen
+oagi agent run "Search weather on Google" --screen-index 1
 ```
 
 CLI options:
@@ -196,6 +206,7 @@ CLI options:
 - `--step-delay`: Delay after each action before next screenshot (default: 0.3s)
 - `--export`: Export format (markdown, html, json)
 - `--export-file`: Output file path for export
+- `--screen-index`: Screen index for multi-screen environments
 
 ### Image Processing
 
@@ -271,20 +282,71 @@ from oagi import AsyncYdotoolActionHandler, YdotoolConfig
 # Customize action behavior
 config = YdotoolConfig(
     scroll_amount=50,        # Larger scroll steps (default: 20)
-    wait_duration=2.0,       # Longer waits (default: 1.0)
-    action_pause=1.0,        # More pause between actions (default: 0.5)
+    wait_duration=2.0,       # Longer waits for WAIT action (default: 1.0)
+    action_pause=1.0,        # Pause between Ydotool calls (default: 0.5)
     capslock_mode="session", # Caps lock mode: 'session' or 'system' (default: 'session')
-    socket_address="/tmp/ydotool.sock"  # Customized Socket address for ydotool (ydotool uses 'YDOTOOL_SOCKET' environment variable by default)
+    socket_address="/tmp/ydotool.sock",  # Custom socket address (default: YDOTOOL_SOCKET env var)
+    post_batch_delay=1.0,    # Delay after actions before next screenshot (default: 1.0)
 )
 
 action_handler = AsyncYdotoolActionHandler(config=config)
 ```
 
+### Multi-Screen Execution
+When running on multi-screen environments, you can choose which screen to use for task execution. The `ScreenManager` class provides methods to list available screens, while the `AsyncPyautoguiActionHandler` and `AsyncScreenshotMaker` classes allow you to set the target screen for actions and screenshots. In the result of `get_all_screens`, the primary screen is always the first one in the list and the remaining screens are appended in the ascending order of their origin coordinates.
+
+```python
+import asyncio
+import sys
+from oagi import ScreenManager
+
+# Must be initialized before importing pyautogui to ensure correct DPI awareness in Windows
+if sys.platform == "win32":
+    ScreenManager.enable_windows_dpi_awareness()
+
+from oagi import (
+    AsyncDefaultAgent,
+    AsyncPyautoguiActionHandler,
+    AsyncScreenshotMaker,
+)
+
+def print_all_screens():
+    """Print all available screens."""
+    screen_manager = ScreenManager()
+    all_screens = screen_manager.get_all_screens()
+    print("Available screens:")
+    for screen_index, screen in enumerate(all_screens):
+        print(f"  - Index {screen_index}: {screen}")
+
+async def main():
+    agent = AsyncDefaultAgent(max_steps=10)
+    action_handler = AsyncPyautoguiActionHandler()
+    image_provider = AsyncScreenshotMaker()
+    # Get all available screens
+    screen_manager = ScreenManager()
+    all_screens = screen_manager.get_all_screens()
+    # Choose a screen for task execution
+    screen_index = 1  # Use the second screen as example
+    target_screen = all_screens[screen_index]
+    # Set the target screen for handlers
+    action_handler.set_target_screen(target_screen)
+    image_provider.set_target_screen(target_screen)
+    completed = await agent.execute(
+        "Search weather on Google",
+        action_handler=action_handler,
+        image_provider=image_provider,
+    )
+    return completed
+
+asyncio.run(main())
+```
+
 ## Examples
 
 See the [`examples/`](examples/) directory for more usage patterns:
 - `execute_task_auto.py` - Automated task execution with `AsyncDefaultAgent`
 - `execute_task_manual.py` - Manual step-by-step control with `Actor`
+- `multi_screen_execution.py` - Automated task execution on multi-screen environments
 - `continued_session.py` - Continuing tasks across sessions
 - `screenshot_with_config.py` - Image compression and optimization
 - `socketio_server_basic.py` - Socket.IO server example

{oagi_core-0.13.2 → oagi_core-0.14.1}/README.md

@@ -108,12 +108,15 @@ from oagi import AsyncPyautoguiActionHandler, PyautoguiConfig
 
 # Customize action behavior
 config = PyautoguiConfig(
-    drag_duration=1.0,      # Slower drags for precision (default: 0.5)
-    scroll_amount=50,       # Larger scroll steps (default: 30)
-    wait_duration=2.0,      # Longer waits (default: 1.0)
-    action_pause=0.2,       # More pause between actions (default: 0.1)
-    hotkey_interval=0.1,    # Interval between keys in hotkey combinations (default: 0.1)
-    capslock_mode="session" # Caps lock mode: 'session' or 'system' (default: 'session')
+    drag_duration=1.0,       # Slower drags for precision (default: 0.5)
+    scroll_amount=50,        # Larger scroll steps (default: 2 on macOS, 100 on others)
+    wait_duration=2.0,       # Longer waits for WAIT action (default: 1.0)
+    action_pause=0.2,        # Pause between PyAutoGUI calls (default: 0.1)
+    hotkey_interval=0.1,     # Interval between keys in hotkey combos (default: 0.1)
+    capslock_mode="session", # Caps lock mode: 'session' or 'system' (default: 'session')
+    macos_ctrl_to_cmd=True,  # Replace ctrl with cmd on macOS (default: True)
+    click_pre_delay=0.1,     # Delay after move before click (default: 0.1)
+    post_batch_delay=1.0,    # Delay after actions before next screenshot (default: 1.0)
 )
 
 action_handler = AsyncPyautoguiActionHandler(config=config)
@@ -139,8 +142,14 @@ oagi agent modes
 # Check macOS permissions (screen recording & accessibility)
 oagi agent permission
 
+# Print all available screens and their indices
+oagi agent screens
+
 # Export execution history
 oagi agent run "Complete the form" --export html --export-file report.html
+
+# Run with a specific screen
+oagi agent run "Search weather on Google" --screen-index 1
 ```
 
 CLI options:
@@ -151,6 +160,7 @@ CLI options:
 - `--step-delay`: Delay after each action before next screenshot (default: 0.3s)
 - `--export`: Export format (markdown, html, json)
 - `--export-file`: Output file path for export
+- `--screen-index`: Screen index for multi-screen environments
 
 ### Image Processing
 
@@ -226,20 +236,71 @@ from oagi import AsyncYdotoolActionHandler, YdotoolConfig
 # Customize action behavior
 config = YdotoolConfig(
     scroll_amount=50,        # Larger scroll steps (default: 20)
-    wait_duration=2.0,       # Longer waits (default: 1.0)
-    action_pause=1.0,        # More pause between actions (default: 0.5)
+    wait_duration=2.0,       # Longer waits for WAIT action (default: 1.0)
+    action_pause=1.0,        # Pause between Ydotool calls (default: 0.5)
     capslock_mode="session", # Caps lock mode: 'session' or 'system' (default: 'session')
-    socket_address="/tmp/ydotool.sock"  # Customized Socket address for ydotool (ydotool uses 'YDOTOOL_SOCKET' environment variable by default)
+    socket_address="/tmp/ydotool.sock",  # Custom socket address (default: YDOTOOL_SOCKET env var)
+    post_batch_delay=1.0,    # Delay after actions before next screenshot (default: 1.0)
 )
 
 action_handler = AsyncYdotoolActionHandler(config=config)
 ```
 
+### Multi-Screen Execution
+When running on multi-screen environments, you can choose which screen to use for task execution. The `ScreenManager` class provides methods to list available screens, while the `AsyncPyautoguiActionHandler` and `AsyncScreenshotMaker` classes allow you to set the target screen for actions and screenshots. In the result of `get_all_screens`, the primary screen is always the first one in the list and the remaining screens are appended in the ascending order of their origin coordinates.
+
+```python
+import asyncio
+import sys
+from oagi import ScreenManager
+
+# Must be initialized before importing pyautogui to ensure correct DPI awareness in Windows
+if sys.platform == "win32":
+    ScreenManager.enable_windows_dpi_awareness()
+
+from oagi import (
+    AsyncDefaultAgent,
+    AsyncPyautoguiActionHandler,
+    AsyncScreenshotMaker,
+)
+
+def print_all_screens():
+    """Print all available screens."""
+    screen_manager = ScreenManager()
+    all_screens = screen_manager.get_all_screens()
+    print("Available screens:")
+    for screen_index, screen in enumerate(all_screens):
+        print(f"  - Index {screen_index}: {screen}")
+
+async def main():
+    agent = AsyncDefaultAgent(max_steps=10)
+    action_handler = AsyncPyautoguiActionHandler()
+    image_provider = AsyncScreenshotMaker()
+    # Get all available screens
+    screen_manager = ScreenManager()
+    all_screens = screen_manager.get_all_screens()
+    # Choose a screen for task execution
+    screen_index = 1  # Use the second screen as example
+    target_screen = all_screens[screen_index]
+    # Set the target screen for handlers
+    action_handler.set_target_screen(target_screen)
+    image_provider.set_target_screen(target_screen)
+    completed = await agent.execute(
+        "Search weather on Google",
+        action_handler=action_handler,
+        image_provider=image_provider,
+    )
+    return completed
+
+asyncio.run(main())
+```
+
 ## Examples
 
 See the [`examples/`](examples/) directory for more usage patterns:
 - `execute_task_auto.py` - Automated task execution with `AsyncDefaultAgent`
 - `execute_task_manual.py` - Manual step-by-step control with `Actor`
+- `multi_screen_execution.py` - Automated task execution on multi-screen environments
 - `continued_session.py` - Continuing tasks across sessions
 - `screenshot_with_config.py` - Image compression and optimization
 - `socketio_server_basic.py` - Socket.IO server example

oagi_core-0.14.1/examples/multi_screen_execution.py

@@ -0,0 +1,74 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+import asyncio
+import sys
+
+from oagi import ScreenManager
+
+# Must be initialized before importing pyautogui to ensure correct DPI awareness in Windows
+if sys.platform == "win32":
+    ScreenManager.enable_windows_dpi_awareness()
+
+from oagi import (
+    AsyncDefaultAgent,
+    AsyncPyautoguiActionHandler,
+    AsyncScreenshotMaker,
+)
+
+
+def print_all_screens():
+    """Print all available screens."""
+    screen_manager = ScreenManager()
+    all_screens = screen_manager.get_all_screens()
+    print("Available screens:")
+    for screen_index, screen in enumerate(all_screens):
+        print(f"  - Index {screen_index}: {screen}")
+
+
+def execute_task_on_specific_screen(task_desc, max_steps=5, screen_index=0):
+    """Synchronous wrapper for async task execution."""
+    # Print all screens and choose one screen for task execution
+    return asyncio.run(
+        async_execute_task_on_specific_screen(task_desc, max_steps, screen_index)
+    )
+
+
+async def async_execute_task_on_specific_screen(task_desc, max_steps=5, screen_index=0):
+    # set OAGI_API_KEY and OAGI_BASE_URL
+    # or AsyncDefaultAgent(api_key="your_api_key", base_url="your_base_url")
+    agent = AsyncDefaultAgent(max_steps=max_steps)
+
+    # executor = lambda actions: print(actions) for debugging
+    action_handler = AsyncPyautoguiActionHandler()
+    image_provider = AsyncScreenshotMaker()
+
+    # Get the target screen info for task execution
+    screen_manager = ScreenManager()
+    all_screens = screen_manager.get_all_screens()
+    screen = all_screens[screen_index]
+    # Set the screen index for handlers
+    action_handler.set_target_screen(screen)
+    image_provider.set_target_screen(screen)
+
+    is_completed = await agent.execute(
+        task_desc,
+        action_handler=action_handler,
+        image_provider=image_provider,
+    )
+
+    return is_completed, await image_provider.last_image()
+
+
+if __name__ == "__main__":
+    # Example task
+    task_desc = "Open Chrome and navigate to google.com"
+    screen_index = 1  # Use the second screen as example
+    success, image = execute_task_on_specific_screen(
+        task_desc, screen_index=screen_index
+    )
+    print(f"\nFinal result: {'Success' if success else 'Failed'}")

{oagi_core-0.13.2 → oagi_core-0.14.1}/metapackage/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi"
-version = "0.13.2"
+version = "0.14.1"
 description = "Official API of OpenAGI Foundation (metapackage with all features)"
 readme = "README.md"
 license = "MIT"
@@ -16,7 +16,7 @@ authors = [
 requires-python = ">= 3.10"
 
 dependencies = [
-    "oagi-core[desktop,server]==0.13.2",
+    "oagi-core[desktop,server]==0.14.1",
 ]
 
 [project.urls]

{oagi_core-0.13.2 → oagi_core-0.14.1}/metapackage/uv.lock

@@ -516,20 +516,29 @@ dependencies = [
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/28/fa/b2ba8229b9381e8f6381c1dcae6f4159a7f72349e414ed19cfbbd1817173/MouseInfo-0.1.3.tar.gz", hash = "sha256:2c62fb8885062b8e520a3cce0a297c657adcc08c60952eb05bc8256ef6f7f6e7", size = 10850, upload-time = "2020-03-27T21:20:10.136Z" }
 
+[[package]]
+name = "mss"
+version = "10.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/40/ca/49b67437a8c46d9732c9c274d7b1fc0c181cfe290d699a0c5e94701dfe79/mss-10.1.0.tar.gz", hash = "sha256:7182baf7ee16ca569e2804028b6ab9bcbf6be5c46fc2880840f33b513b9cb4f8", size = 84200, upload-time = "2025-08-16T12:11:00.119Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/23/28/1e3e5cd1d677cca68b26166f704f72e35b1e8b6d5076d8ebeebc4e40a649/mss-10.1.0-py3-none-any.whl", hash = "sha256:9179c110cadfef5dc6dc4a041a0cd161c74c379218648e6640b48c6b5cfe8918", size = 24525, upload-time = "2025-08-16T12:10:59.111Z" },
+]
+
 [[package]]
 name = "oagi"
-version = "0.13.2"
+version = "0.14.1"
 source = { editable = "." }
 dependencies = [
     { name = "oagi-core", extra = ["desktop", "server"] },
 ]
 
 [package.metadata]
-requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.13.1" }]
+requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.14.0" }]
 
 [[package]]
 name = "oagi-core"
-version = "0.13.1"
+version = "0.14.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -537,13 +546,14 @@ dependencies = [
     { name = "pydantic" },
     { name = "rich" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/62/b0/6006c57afc693a4afdc5389f1c93e83654745ec2b25d33c091621aec7d15/oagi_core-0.13.1.tar.gz", hash = "sha256:8dcbf45c6eb7203573d04122ebb53c67d7c955bb6bbfe8332fe2e641e7cb689f", size = 304385, upload-time = "2026-01-12T04:14:18.758Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/4d/2f/74a0a8df68ad16e66f5d84df40c439d4de059b9d2cce8b95972f7e9ff7a6/oagi_core-0.14.0.tar.gz", hash = "sha256:d72f0e81b6427ec08642678df297ff1b73b40c856d4c78df33d7e541af3bd6fd", size = 309074, upload-time = "2026-01-20T15:24:11.961Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/6e/78/0a04d5a28313ab6dc783a5c4d8b32c1871fa2a140f75dfe42f56024c8865/oagi_core-0.13.1-py3-none-any.whl", hash = "sha256:b29637ca080fa7092224231b113b35c07f09657bed203e8e26e13e2c2a65665f", size = 110049, upload-time = "2026-01-12T04:14:17.645Z" },
+    { url = "https://files.pythonhosted.org/packages/22/c7/8061f05bf2f5225a0424ec890f50b8b38dc1e44489232a82a2405ea4a1c5/oagi_core-0.14.0-py3-none-any.whl", hash = "sha256:011a33b641dd5a881e9322bbb82e3394921574b8ce840e99b21f2de02f2d71c5", size = 114399, upload-time = "2026-01-20T15:24:10.801Z" },
 ]
 
 [package.optional-dependencies]
 desktop = [
+    { name = "mss", marker = "sys_platform == 'win32'" },
     { name = "pillow" },
     { name = "pyautogui" },
     { name = "pyobjc-framework-applicationservices", marker = "sys_platform == 'darwin'" },

{oagi_core-0.13.2 → oagi_core-0.14.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi-core"
-version = "0.13.2"
+version = "0.14.1"
 description = "Official API of OpenAGI Foundation"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -33,7 +33,8 @@ desktop = [
     "pyautogui>=0.9.54",
     "pyobjc-framework-Quartz>=8.0; sys_platform == 'darwin'",
     "pyobjc-framework-ApplicationServices>=8.0; sys_platform == 'darwin'",
-    "screeninfo>=0.8.1"
+    "screeninfo>=0.8.1",
+    "mss>=9.0.0; sys_platform == 'win32'",
 ]
 server = [
     "fastapi[standard]>=0.100.0",

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/__init__.py

@@ -81,6 +81,7 @@ _LAZY_IMPORTS_DATA: dict[str, tuple[str, str | None, str | None]] = {
         "screeninfo",
         "desktop",
     ),
+    "ScreenManager": ("oagi.handler.screen_manager", None, None),
 }
 
 if TYPE_CHECKING:
@@ -95,6 +96,7 @@ if TYPE_CHECKING:
         PyautoguiActionHandler,
         PyautoguiConfig,
     )
+    from oagi.handler.screen_manager import ScreenManager
     from oagi.handler.screenshot_maker import ScreenshotMaker
     from oagi.handler.ydotool_action_handler import YdotoolActionHandler, YdotoolConfig
     from oagi.server.config import ServerConfig
@@ -170,4 +172,6 @@ __all__ = [
     "AsyncYdotoolActionHandler",
     "YdotoolActionHandler",
     "YdotoolConfig",
+    # Lazy imports - Screen manager
+    "ScreenManager",
 ]

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/agent/default.py

@@ -6,7 +6,6 @@
 #  Licensed under the MIT License.
 # -----------------------------------------------------------------------------
 
-import asyncio
 import logging
 
 from .. import AsyncActor
@@ -16,7 +15,7 @@ from ..constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
-from ..handler.utils import reset_handler
+from ..handler.utils import configure_handler_delay, reset_handler
 from ..types import (
     ActionEvent,
     AsyncActionHandler,
@@ -72,6 +71,9 @@ class AsyncDefaultAgent:
             # Reset handler state at automation start
             reset_handler(action_handler)
 
+            # Configure handler's post_batch_delay from agent's step_delay
+            configure_handler_delay(action_handler, self.step_delay)
+
             for i in range(self.max_steps):
                 step_num = i + 1
                 logger.debug(f"Executing step {step_num}/{self.max_steps}")
@@ -127,10 +129,6 @@ class AsyncDefaultAgent:
                             )
                         )
 
-                # Wait after actions before next screenshot
-                if self.step_delay > 0:
-                    await asyncio.sleep(self.step_delay)
-
                 # Check if task is complete
                 if step.stop:
                     logger.info(f"Task completed successfully after {step_num} steps")

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/agent/tasker/taskee_agent.py

@@ -6,7 +6,6 @@
 #  Licensed under the MIT License.
 # -----------------------------------------------------------------------------
 
-import asyncio
 import logging
 from datetime import datetime
 from typing import Any
@@ -19,7 +18,7 @@ from oagi.constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
-from oagi.handler.utils import reset_handler
+from oagi.handler.utils import configure_handler_delay, reset_handler
 from oagi.types import (
     URL,
     ActionEvent,
@@ -126,6 +125,9 @@ class TaskeeAgent(AsyncAgent):
         # Reset handler state at todo execution start
         reset_handler(action_handler)
 
+        # Configure handler's post_batch_delay from agent's step_delay
+        configure_handler_delay(action_handler, self.step_delay)
+
         self.current_todo = instruction
         self.actions = []
         self.total_actions = 0
@@ -355,10 +357,6 @@ class TaskeeAgent(AsyncAgent):
                 self.total_actions += len(step.actions)
                 self.since_reflection += len(step.actions)
 
-            # Wait after actions before next screenshot
-            if self.step_delay > 0:
-                await asyncio.sleep(self.step_delay)
-
             steps_taken += 1
 
             # Check if task is complete

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/cli/agent.py

@@ -86,6 +86,11 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
         type=float,
         help=f"Delay in seconds after each step before next screenshot (default: {DEFAULT_STEP_DELAY})",
     )
+    run_parser.add_argument(
+        "--screen-index",
+        type=int,
+        help="Choose the index of screen to run the task",
+    )
 
     # agent modes command
     agent_subparsers.add_parser("modes", help="List available agent modes")
@@ -96,6 +101,11 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
         help="Check macOS permissions for screen recording and accessibility",
     )
 
+    # agent screens command
+    agent_subparsers.add_parser(
+        "screens", help="List all available screens for agent execution"
+    )
+
 
 def handle_agent_command(args: argparse.Namespace) -> None:
     if args.agent_command == "run":
@@ -104,6 +114,19 @@ def handle_agent_command(args: argparse.Namespace) -> None:
         list_modes()
     elif args.agent_command == "permission":
         check_permissions()
+    elif args.agent_command == "screens":
+        list_screens()
+
+
+def list_screens() -> None:
+    """List all available screens for agent execution."""
+    from oagi import ScreenManager  # noqa: PLC0415
+
+    screen_manager = ScreenManager()
+    screens = screen_manager.get_all_screens()
+    print("Available screens:")
+    for screen_index, screen in enumerate(screens):
+        print(f"  - Index {screen_index}: {screen}")
 
 
 def list_modes() -> None:
@@ -212,6 +235,22 @@ def run_agent(args: argparse.Namespace) -> None:
     from oagi.agent import create_agent  # noqa: PLC0415
     from oagi.handler.wayland_support import is_wayland_display_server  # noqa: PLC0415
 
+    # Create screen manager for multi-screen support
+    # Must be initialized before importing pyautogui to ensure correct DPI awareness in Windows
+    target_screen = None
+    if args.screen_index is not None:
+        from oagi.handler import ScreenManager  # noqa: PLC0415
+
+        screen_index = args.screen_index
+        screen_manager = ScreenManager()
+        all_screens = screen_manager.get_all_screens()
+        if screen_index >= len(all_screens) or screen_index < 0:
+            raise ValueError(
+                f"Error: Screen index {screen_index} not found. Available screen indices: {list(range(len(all_screens)))}"
+            )
+        target_screen = all_screens[screen_index]
+        print(f"Target screen: {target_screen}")
+
     # Select appropriate action handler based on display server
     if is_wayland_display_server():
         check_optional_dependency("screeninfo", "Agent execution (Wayland)", "desktop")
@@ -280,6 +319,11 @@ def run_agent(args: argparse.Namespace) -> None:
     # Create image provider
     image_provider = AsyncScreenshotMaker()
 
+    if target_screen:
+        # Set the target screen for the image and action provider
+        image_provider.set_target_screen(target_screen)
+        action_handler.set_target_screen(target_screen)
+
     if args.instruction:
         print(f"Starting agent with instruction: {args.instruction}")
     else:

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/constants.py

@@ -35,7 +35,7 @@ DEFAULT_REFLECTION_INTERVAL = 4
 DEFAULT_REFLECTION_INTERVAL_TASKER = 20
 
 # Timing & Delays
-DEFAULT_STEP_DELAY = 0.3
+DEFAULT_STEP_DELAY = 1.0
 
 # Temperature Defaults
 DEFAULT_TEMPERATURE = 0.5

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/handler/__init__.py

@@ -21,6 +21,7 @@ _LAZY_IMPORTS: dict[str, str] = {
     "AsyncYdotoolActionHandler": "oagi.handler.async_ydotool_action_handler",
     "YdotoolActionHandler": "oagi.handler.ydotool_action_handler",
     "YdotoolConfig": "oagi.handler.ydotool_action_handler",
+    "ScreenManager": "oagi.handler.screen_manager",
 }
 
 if TYPE_CHECKING:
@@ -32,6 +33,7 @@ if TYPE_CHECKING:
         PyautoguiActionHandler,
         PyautoguiConfig,
     )
+    from oagi.handler.screen_manager import ScreenManager
     from oagi.handler.screenshot_maker import ScreenshotMaker
     from oagi.handler.ydotool_action_handler import YdotoolActionHandler, YdotoolConfig
 
@@ -60,4 +62,5 @@ __all__ = [
     "YdotoolConfig",
     "YdotoolActionHandler",
     "AsyncYdotoolActionHandler",
+    "ScreenManager",
 ]

{oagi_core-0.13.2 → oagi_core-0.14.1}/src/oagi/handler/async_pyautogui_action_handler.py

@@ -8,6 +8,8 @@
 
 import asyncio
 
+from oagi.handler.screen_manager import Screen
+
 from ..types import Action
 from .pyautogui_action_handler import PyautoguiActionHandler, PyautoguiConfig
 
@@ -27,7 +29,16 @@ class AsyncPyautoguiActionHandler:
             config: PyautoguiConfig instance for customizing behavior
         """
         self.sync_handler = PyautoguiActionHandler(config=config)
-        self.config = config or PyautoguiConfig()
+        # Share the same config object so configure_handler_delay() works
+        self.config = self.sync_handler.config
+
+    def set_target_screen(self, screen: Screen) -> None:
+        """Set the target screen for the action handler.
+
+        Args:
+            screen (Screen): The screen object to set as the target.
+        """
+        self.sync_handler.set_target_screen(screen)
 
     def reset(self):
         """Reset handler state.