oagi-core 0.12.0__py3-none-any.whl → 0.13.0__py3-none-any.whl

oagi/__init__.py

@@ -6,8 +6,11 @@
 #  Licensed under the MIT License.
 # -----------------------------------------------------------------------------
 import importlib
+import importlib.metadata
 from typing import TYPE_CHECKING
 
+__version__ = importlib.metadata.version("oagi-core")
+
 from oagi.actor import Actor, AsyncActor, AsyncShortTask, AsyncTask, ShortTask, Task
 from oagi.client import AsyncClient, SyncClient
 from oagi.exceptions import (
@@ -62,6 +65,22 @@ _LAZY_IMPORTS_DATA: dict[str, tuple[str, str | None, str | None]] = {
     "create_app": ("oagi.server.main", "socketio", "server"),
     "ServerConfig": ("oagi.server.config", "pydantic_settings", "server"),
     "sio": ("oagi.server.socketio_server", "socketio", "server"),
+    # Wayland handlers
+    "AsyncYdotoolActionHandler": (
+        "oagi.handler.async_ydotool_action_handler",
+        "screeninfo",
+        "desktop",
+    ),
+    "YdotoolActionHandler": (
+        "oagi.handler.ydotool_action_handler",
+        "screeninfo",
+        "desktop",
+    ),
+    "YdotoolConfig": (
+        "oagi.handler.ydotool_action_handler",
+        "screeninfo",
+        "desktop",
+    ),
 }
 
 if TYPE_CHECKING:
@@ -70,12 +89,14 @@ if TYPE_CHECKING:
     from oagi.agent.tasker import TaskerAgent
     from oagi.handler.async_pyautogui_action_handler import AsyncPyautoguiActionHandler
     from oagi.handler.async_screenshot_maker import AsyncScreenshotMaker
+    from oagi.handler.async_ydotool_action_handler import AsyncYdotoolActionHandler
     from oagi.handler.pil_image import PILImage
     from oagi.handler.pyautogui_action_handler import (
         PyautoguiActionHandler,
         PyautoguiConfig,
     )
     from oagi.handler.screenshot_maker import ScreenshotMaker
+    from oagi.handler.ydotool_action_handler import YdotoolActionHandler, YdotoolConfig
     from oagi.server.config import ServerConfig
     from oagi.server.main import create_app
     from oagi.server.socketio_server import sio
@@ -98,6 +119,8 @@ def __dir__() -> list[str]:
 
 
 __all__ = [
+    # Version
+    "__version__",
     # Core sync classes
     "Actor",
     "AsyncActor",
@@ -143,4 +166,8 @@ __all__ = [
     "create_app",
     "ServerConfig",
     "sio",
+    # Lazy imports - Wayland handler classes
+    "AsyncYdotoolActionHandler",
+    "YdotoolActionHandler",
+    "YdotoolConfig",
 ]

oagi/agent/default.py

@@ -16,7 +16,7 @@ from ..constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
-from ..handler import reset_handler
+from ..handler.utils import reset_handler
 from ..types import (
     ActionEvent,
     AsyncActionHandler,

oagi/agent/tasker/taskee_agent.py

@@ -19,7 +19,7 @@ from oagi.constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
-from oagi.handler import reset_handler
+from oagi.handler.utils import reset_handler
 from oagi.types import (
     URL,
     ActionEvent,

oagi/agent/tasker/tasker_agent.py

@@ -16,7 +16,7 @@ from oagi.constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
-from oagi.handler import reset_handler
+from oagi.handler.utils import reset_handler
 from oagi.types import AsyncActionHandler, AsyncImageProvider, AsyncObserver, SplitEvent
 
 from ..protocol import AsyncAgent

oagi/cli/agent.py

@@ -206,14 +206,25 @@ def _warn_missing_permissions() -> None:
 
 def run_agent(args: argparse.Namespace) -> None:
     # Check if desktop extras are installed
-    check_optional_dependency("pyautogui", "Agent execution", "desktop")
     check_optional_dependency("PIL", "Agent execution", "desktop")
 
-    # Warn about missing macOS permissions (non-blocking)
-    _warn_missing_permissions()
-
-    from oagi import AsyncPyautoguiActionHandler, AsyncScreenshotMaker  # noqa: PLC0415
+    from oagi import AsyncScreenshotMaker  # noqa: PLC0415
     from oagi.agent import create_agent  # noqa: PLC0415
+    from oagi.handler.wayland_support import is_wayland_display_server  # noqa: PLC0415
+
+    # Select appropriate action handler based on display server
+    if is_wayland_display_server():
+        check_optional_dependency("screeninfo", "Agent execution (Wayland)", "desktop")
+        from oagi import AsyncYdotoolActionHandler  # noqa: PLC0415
+
+        action_handler = AsyncYdotoolActionHandler()
+    else:
+        check_optional_dependency("pyautogui", "Agent execution", "desktop")
+        # Warn about missing macOS permissions (non-blocking)
+        _warn_missing_permissions()
+        from oagi import AsyncPyautoguiActionHandler  # noqa: PLC0415
+
+        action_handler = AsyncPyautoguiActionHandler()
 
     # Get configuration
     api_key = args.oagi_api_key or os.getenv("OAGI_API_KEY")
@@ -266,8 +277,7 @@ def run_agent(args: argparse.Namespace) -> None:
     # Create agent
     agent = create_agent(**agent_kwargs)
 
-    # Create handlers
-    action_handler = AsyncPyautoguiActionHandler()
+    # Create image provider
     image_provider = AsyncScreenshotMaker()
 
     if args.instruction:

oagi/client/async_.py

@@ -19,6 +19,7 @@ from ..constants import (
     HTTP_CLIENT_TIMEOUT,
 )
 from ..logging import get_logger
+from ..platform_info import get_sdk_headers
 from ..types import Image
 from ..types.models import GenerateResponse, UploadFileResponse, Usage
 from ..types.models.step import Step
@@ -54,17 +55,21 @@ class AsyncClient(BaseClient[httpx.AsyncClient]):
     ):
         super().__init__(base_url, api_key, max_retries)
 
+        # Get SDK headers for all clients
+        sdk_headers = get_sdk_headers()
+
         # OpenAI client for chat completions (with retries)
         self.openai_client = AsyncOpenAI(
             api_key=self.api_key,
             base_url=f"{self.base_url}/v1",
             max_retries=self.max_retries,
+            default_headers=sdk_headers,
         )
 
         # httpx clients for S3 uploads and other endpoints (with retries)
         transport = AsyncHTTPTransport(retries=self.max_retries)
         self.http_client = httpx.AsyncClient(
-            transport=transport, base_url=self.base_url
+            transport=transport, base_url=self.base_url, headers=sdk_headers
         )
         self.upload_client = httpx.AsyncClient(
             transport=transport, timeout=HTTP_CLIENT_TIMEOUT

oagi/client/base.py

@@ -29,6 +29,7 @@ from ..exceptions import (
     ValidationError,
 )
 from ..logging import get_logger
+from ..platform_info import get_sdk_headers
 from ..types.models import (
     ErrorResponse,
     GenerateResponse,
@@ -73,7 +74,7 @@ class BaseClient(Generic[HttpClientT]):
         logger.info(f"Client initialized with base_url: {self.base_url}")
 
     def _build_headers(self, api_version: str | None = None) -> dict[str, str]:
-        headers: dict[str, str] = {}
+        headers = get_sdk_headers()
         if api_version:
             headers["x-api-version"] = api_version
         if self.api_key:

oagi/client/sync.py

@@ -19,6 +19,7 @@ from ..constants import (
     HTTP_CLIENT_TIMEOUT,
 )
 from ..logging import get_logger
+from ..platform_info import get_sdk_headers
 from ..types import Image
 from ..types.models import GenerateResponse, UploadFileResponse, Usage
 from ..types.models.step import Step
@@ -54,16 +55,22 @@ class SyncClient(BaseClient[httpx.Client]):
     ):
         super().__init__(base_url, api_key, max_retries)
 
+        # Get SDK headers for all clients
+        sdk_headers = get_sdk_headers()
+
         # OpenAI client for chat completions (with retries)
         self.openai_client = OpenAI(
             api_key=self.api_key,
             base_url=f"{self.base_url}/v1",
             max_retries=self.max_retries,
+            default_headers=sdk_headers,
         )
 
         # httpx clients for S3 uploads and other endpoints (with retries)
         transport = HTTPTransport(retries=self.max_retries)
-        self.http_client = httpx.Client(transport=transport, base_url=self.base_url)
+        self.http_client = httpx.Client(
+            transport=transport, base_url=self.base_url, headers=sdk_headers
+        )
         self.upload_client = httpx.Client(
             transport=transport, timeout=HTTP_CLIENT_TIMEOUT
         )

oagi/handler/__init__.py

@@ -5,28 +5,48 @@
 #  This file is part of the official API project.
 #  Licensed under the MIT License.
 # -----------------------------------------------------------------------------
-from oagi.handler.async_pyautogui_action_handler import AsyncPyautoguiActionHandler
-from oagi.handler.async_screenshot_maker import AsyncScreenshotMaker
-from oagi.handler.pil_image import PILImage
-from oagi.handler.pyautogui_action_handler import (
-    PyautoguiActionHandler,
-    PyautoguiConfig,
-)
-from oagi.handler.screenshot_maker import ScreenshotMaker
+import importlib
+from typing import TYPE_CHECKING
 
+from .utils import reset_handler
 
-def reset_handler(handler) -> None:
-    """Reset handler state if supported.
+# Lazy imports for pyautogui-dependent modules to avoid import errors on headless systems
+_LAZY_IMPORTS: dict[str, str] = {
+    "AsyncPyautoguiActionHandler": "oagi.handler.async_pyautogui_action_handler",
+    "AsyncScreenshotMaker": "oagi.handler.async_screenshot_maker",
+    "PILImage": "oagi.handler.pil_image",
+    "PyautoguiActionHandler": "oagi.handler.pyautogui_action_handler",
+    "PyautoguiConfig": "oagi.handler.pyautogui_action_handler",
+    "ScreenshotMaker": "oagi.handler.screenshot_maker",
+    "AsyncYdotoolActionHandler": "oagi.handler.async_ydotool_action_handler",
+    "YdotoolActionHandler": "oagi.handler.ydotool_action_handler",
+    "YdotoolConfig": "oagi.handler.ydotool_action_handler",
+}
 
-    Uses duck-typing to check if the handler has a reset() method.
-    This allows handlers to reset their internal state (e.g., capslock state)
-    at the start of a new automation task.
+if TYPE_CHECKING:
+    from oagi.handler.async_pyautogui_action_handler import AsyncPyautoguiActionHandler
+    from oagi.handler.async_screenshot_maker import AsyncScreenshotMaker
+    from oagi.handler.async_ydotool_action_handler import AsyncYdotoolActionHandler
+    from oagi.handler.pil_image import PILImage
+    from oagi.handler.pyautogui_action_handler import (
+        PyautoguiActionHandler,
+        PyautoguiConfig,
+    )
+    from oagi.handler.screenshot_maker import ScreenshotMaker
+    from oagi.handler.ydotool_action_handler import YdotoolActionHandler, YdotoolConfig
 
-    Args:
-        handler: The action handler to reset
-    """
-    if hasattr(handler, "reset"):
-        handler.reset()
+
+def __getattr__(name: str):
+    """Lazy import for pyautogui-dependent modules."""
+    if name in _LAZY_IMPORTS:
+        module = importlib.import_module(_LAZY_IMPORTS[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    """Return all public names including lazy imports."""
+    return sorted(set(__all__) | set(_LAZY_IMPORTS.keys()))
 
 
 __all__ = [
@@ -37,4 +57,7 @@ __all__ = [
     "ScreenshotMaker",
     "AsyncScreenshotMaker",
     "reset_handler",
+    "YdotoolConfig",
+    "YdotoolActionHandler",
+    "AsyncYdotoolActionHandler",
 ]

oagi/handler/_ydotool.py

@@ -0,0 +1,158 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+"""
+Taken from /usr/include/linux/input-event-codes.h
+
+The keys supported in this mapping are the same as the keys supported in pyautogui.
+"""
+
+KEYCODE_MAP = {
+    # Letters
+    "a": 30,
+    "s": 31,
+    "d": 32,
+    "f": 33,
+    "h": 35,
+    "g": 34,
+    "z": 44,
+    "x": 45,
+    "c": 46,
+    "v": 47,
+    "b": 48,
+    "q": 16,
+    "w": 17,
+    "e": 18,
+    "r": 19,
+    "y": 21,
+    "t": 20,
+    "o": 24,
+    "u": 22,
+    "i": 23,
+    "p": 25,
+    "l": 38,
+    "j": 36,
+    "k": 37,
+    "n": 49,
+    "m": 50,
+    # Numbers and shifted symbols
+    "1": 2,
+    "!": 2,
+    "2": 3,
+    "@": 3,
+    "3": 4,
+    "#": 4,
+    "4": 5,
+    "$": 5,
+    "5": 6,
+    "%": 6,
+    "6": 7,
+    "^": 7,
+    "7": 8,
+    "&": 8,
+    "8": 9,
+    "*": 9,
+    "9": 10,
+    "(": 10,
+    "0": 11,
+    ")": 11,
+    # Punctuation and symbols
+    "-": 12,
+    "_": 12,  # KEY_MINUS
+    "=": 13,
+    "+": 13,  # KEY_EQUAL
+    "[": 26,
+    "{": 26,  # KEY_LEFTBRACE
+    "]": 27,
+    "}": 27,  # KEY_RIGHTBRACE
+    ";": 39,
+    ":": 39,  # KEY_SEMICOLON
+    "'": 40,
+    '"': 40,  # KEY_APOSTROPHE
+    "`": 41,
+    "~": 41,  # KEY_GRAVE
+    "\\": 43,
+    "|": 43,  # KEY_BACKSLASH
+    ",": 51,
+    "<": 51,  # KEY_COMMA
+    ".": 52,
+    ">": 52,  # KEY_DOT
+    "/": 53,
+    "?": 53,  # KEY_SLASH
+    # Whitespace
+    " ": 57,
+    "space": 57,
+    "\t": 15,
+    "tab": 15,
+    # Enter / Backspace / Esc
+    "\r": 28,
+    "\n": 28,
+    "enter": 28,
+    "return": 28,
+    "backspace": 14,
+    "\b": 14,
+    "esc": 1,
+    "escape": 1,
+    # Modifiers
+    "shift": 42,
+    "shiftleft": 42,
+    "shiftright": 54,
+    "capslock": 58,
+    "ctrl": 29,
+    "ctrlleft": 29,
+    "ctrlright": 97,
+    "alt": 56,
+    "altleft": 56,
+    "option": 56,
+    "optionleft": 56,
+    "optionright": 100,
+    "command": 125,  # map to KEY_LEFTMETA
+    "fn": 464,  # KEY_FN (0x1d0)
+    # Function keys
+    "f1": 59,
+    "f2": 60,
+    "f3": 61,
+    "f4": 62,
+    "f5": 63,
+    "f6": 64,
+    "f7": 65,
+    "f8": 66,
+    "f9": 67,
+    "f10": 68,
+    "f11": 87,
+    "f12": 88,
+    "f13": 183,
+    "f14": 184,
+    "f15": 185,
+    "f16": 186,
+    "f17": 187,
+    "f18": 188,
+    "f19": 189,
+    "f20": 190,
+    # Navigation
+    "home": 102,
+    "end": 107,
+    "pageup": 104,
+    "pgup": 104,
+    "pagedown": 109,
+    "pgdn": 109,
+    "left": 105,
+    "right": 106,
+    "up": 103,
+    "down": 108,
+    "del": 111,
+    "delete": 111,
+    # Media
+    "volumeup": 115,
+    "volumedown": 114,
+    "volumemute": 113,
+    # Locale-specific keys
+    "yen": 124,  # KEY_YEN
+    "eisu": 85,  # mapped to KEY_ZENKAKUHANKAKU (common JIS toggle)
+    "kana": 90,  # KEY_KATAKANA
+    "help": 138,  # KEY_HELP
+}

oagi/handler/async_ydotool_action_handler.py

@@ -0,0 +1,52 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+import asyncio
+
+from ..types import Action
+from .ydotool_action_handler import YdotoolActionHandler, YdotoolConfig
+
+
+class AsyncYdotoolActionHandler:
+    """
+    Async wrapper for YdotoolActionHandler that runs actions in a thread pool.
+
+    This allows Ydotool operations to be non-blocking in async contexts,
+    enabling concurrent execution of other async tasks while GUI actions are performed.
+    """
+
+    def __init__(self, config: YdotoolConfig | None = None):
+        """Initialize with optional configuration.
+
+        Args:
+            config: YdotoolConfig instance for customizing behavior
+        """
+        self.config = config or YdotoolConfig()
+        self.sync_handler = YdotoolActionHandler(config=self.config)
+
+    def reset(self):
+        """Reset handler state.
+
+        Delegates to the underlying synchronous handler's reset method.
+        Called at automation start/end and when FINISH action is received.
+        """
+        self.sync_handler.reset()
+
+    async def __call__(self, actions: list[Action]) -> None:
+        """
+        Execute actions asynchronously using a thread pool executor.
+
+        This prevents PyAutoGUI operations from blocking the async event loop,
+        allowing other coroutines to run while GUI actions are being performed.
+
+        Args:
+            actions: List of actions to execute
+        """
+        loop = asyncio.get_event_loop()
+        # Run the synchronous handler in a thread pool to avoid blocking
+        await loop.run_in_executor(None, self.sync_handler, actions)

oagi/handler/pil_image.py

@@ -10,6 +10,8 @@ import io
 
 from ..exceptions import check_optional_dependency
 from ..types.models.image_config import ImageConfig
+from .wayland_support import is_wayland_display_server
+from .wayland_support import screenshot as wayland_screenshot
 
 check_optional_dependency("PIL", "PILImage", "desktop")
 from PIL import Image as PILImageLib  # noqa: E402
@@ -39,6 +41,10 @@ class PILImage:
     @classmethod
     def from_screenshot(cls, config: ImageConfig | None = None) -> "PILImage":
         """Create PILImage from screenshot."""
+        # Use flameshot by default in Wayland display environment
+        if is_wayland_display_server():
+            return cls(wayland_screenshot(), config)
+
         # Lazy import to avoid DISPLAY issues in headless environments
         check_optional_dependency("pyautogui", "PILImage.from_screenshot()", "desktop")
         import pyautogui  # noqa: PLC0415

oagi/handler/utils.py

@@ -0,0 +1,21 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+
+def reset_handler(handler) -> None:
+    """Reset handler state if supported.
+
+    Uses duck-typing to check if the handler has a reset() method.
+    This allows handlers to reset their internal state (e.g., capslock state)
+    at the start of a new automation task.
+
+    Args:
+        handler: The action handler to reset
+    """
+    if hasattr(handler, "reset"):
+        handler.reset()

oagi/handler/wayland_support.py

@@ -0,0 +1,219 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+import io
+import logging
+import os
+import shlex
+import shutil
+import subprocess
+import time
+
+from screeninfo import get_monitors
+
+from ..exceptions import check_optional_dependency
+from ._ydotool import KEYCODE_MAP
+
+check_optional_dependency("PIL", "PILImage", "desktop")
+from PIL import Image  # noqa: E402
+
+logger = logging.getLogger(__name__)
+
+
+def is_wayland_display_server() -> bool:
+    """Check if Wayland is the current display server."""
+    return os.environ.get("WAYLAND_DISPLAY") is not None
+
+
+def get_screen_size() -> tuple[int, int]:
+    """Get the screen size in pixels."""
+    for monitor in get_monitors():
+        if monitor.is_primary:
+            return monitor.width, monitor.height
+
+    # Fallback if no monitor is marked primary
+    monitors = get_monitors()
+    if monitors:
+        return monitors[0].width, monitors[0].height
+    raise Exception("No monitor found, cannot get the screen size info")
+
+
+def screenshot() -> Image:
+    """
+    Use Flameshot to take a screenshot and return an Image object
+
+    :return: Image object of the screenshot
+    """
+    # Check if flameshot is installed
+    if shutil.which("flameshot") is None:
+        raise RuntimeError("flameshot not found. Ensure it is installed and in PATH.")
+    cmd = ["flameshot", "full", "--region", "all", "--raw"]
+    res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    if res.returncode != 0:
+        raise RuntimeError(
+            f"flameshot failed: {shlex.join(cmd)}, stdout: {res.stdout.decode(errors='ignore')}, stderr: {res.stderr.decode(errors='ignore')}"
+        )
+    im = Image.open(io.BytesIO(res.stdout))
+    im.load()
+    return im
+
+
+class Ydotool:
+    """
+    Ydotool wrapper for Wayland display server.
+
+    :param socket_address: The socket address for ydotool, default is empty string.
+    """
+
+    def __init__(self, socket_address: str = "") -> None:
+        # Check if ydotool is installed
+        if shutil.which("ydotool") is None:
+            raise RuntimeError("ydotool not found. Ensure it is installed and in PATH.")
+        # Set default delay between actions
+        self.action_pause = 0.5
+        # Last action time
+        self.last_action_time = 0.0
+        # Customize the socket address for ydotool
+        self.socket_address = socket_address
+        # Check environment issues for ydotool
+        self.environ_check()
+
+    def environ_check(self):
+        """Check environment issues for ydotool"""
+        # Check if ydotoold is running
+        if not subprocess.run(
+            ["pgrep", "ydotoold"], capture_output=True, text=True
+        ).stdout.strip():
+            logger.warning("Ydotool daemon (ydotoold) is not running")
+        # Check the permission to access the socket address
+        socket_address = (
+            self.socket_address
+            or os.environ.get("YDOTOOL_SOCKET", "")
+            or f"/run/user/{os.getuid()}/.ydotool_socket"
+        )
+        if not os.access(socket_address, os.W_OK) or not os.path.exists(socket_address):
+            logger.warning(f"Ydotool cannot connect to socket address:{socket_address}")
+        # Check if the mouse acceleration profile is 'flat' (For GNOME)
+        accel_profile = subprocess.run(
+            [
+                "gsettings",
+                "get",
+                "org.gnome.desktop.peripherals.mouse",
+                "accel-profile",
+            ],
+            capture_output=True,
+            text=True,
+        ).stdout.strip()
+        if accel_profile and accel_profile != "'flat'":
+            logger.warning(
+                f"Mouse Acceleration is not disabled, current accel-profile is {accel_profile}). Ydotool may not work as expected."
+                + "Please disable mouse acceleration by running 'gsettings set org.gnome.desktop.peripherals.mouse accel-profile 'flat''",
+            )
+
+    def _get_keycode(self, key_char: str) -> int:
+        """
+        Get the keycode from input-event-codes mapping.
+        :param key_char: Key char (e.g., "A", "ENTER", "F1", "PRINT_SCREEN", case-insensitive)
+        :return: Decimal keycode
+        """
+        # Lookup and return keycode
+        if key_char in KEYCODE_MAP:
+            return KEYCODE_MAP[key_char]
+        else:
+            return None
+
+    def _run_ydotool(self, args: list[str], count: int = 1) -> None:
+        """
+        Run ydotool command; e.g., ["click", "500", "300"] => ydotool click 500 300
+        """
+        if (interval := (time.time() - self.last_action_time)) < self.action_pause:
+            time.sleep(interval)
+        if count > 1:
+            args.extend(["--repeat", str(count)])
+        cmd = ["ydotool", *args]
+        # Use shlex.join for clear logging
+        logger.debug(f"[ydotool] {shlex.join(cmd)}")
+        # Env with socket address
+        env = os.environ.copy()
+        if self.socket_address:
+            env["YDOTOOL_SOCKET"] = self.socket_address
+        # Run ydotool command
+        res = subprocess.run(
+            cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, env=env
+        )
+        if res.returncode != 0:
+            raise RuntimeError(
+                f"ydotool failed: {shlex.join(cmd)}, stdout: {res.stdout.decode(errors='ignore').strip()}, stderr: {res.stderr.decode(errors='ignore').strip()}"
+            )
+        self.last_action_time = time.time()
+
+    def drag(self, x1: int, y1: int, x2: int, y2: int, count: int = 1) -> None:
+        """
+        Drag from (x1, y1) to (x2, y2).
+
+        """
+        for _ in range(count):
+            self.mousemove(x1, y1)
+            self._run_ydotool(["click", "0x40"])
+            self.mousemove(x2, y2)
+            self._run_ydotool(["click", "0x80"])
+
+    def mousemove(self, x: int, y: int, count: int = 1) -> None:
+        """
+        Move mouse to (x, y).
+        :param x: X coordinate of the mouse cursor
+        :param y: Y coordinate of the mouse cursor
+        :param count: Number of mouse move actions to perform
+        """
+        self._run_ydotool(
+            ["mousemove", "--absolute", "-x", str(x), "-y", str(y)], count=count
+        )
+
+    def scroll(self, clicks: float) -> None:
+        """
+        Scroll mouse wheel in the given direction.
+        :param clicks: Number of clicks to scroll, positive for up, negative for down
+        """
+        self._run_ydotool(
+            [
+                "mousemove",
+                "-w",
+                "--",
+                "0",
+                str(clicks),
+            ],
+        )
+
+    def click(self, x: int, y: int, count: int = 1, right: bool = False) -> None:
+        """
+        Click at (x, y).
+        """
+        self.mousemove(x, y)
+        if right:
+            click_key = "0xC1"
+        else:
+            click_key = "0xC0"
+        self._run_ydotool(["click", click_key], count=count)
+
+    def type(self, text: str, count: int = 1) -> None:
+        """
+        Type the given text.
+        """
+        self._run_ydotool(["type", text], count=count)
+
+    def hotkey(self, keys: list[str], count: int = 1) -> None:
+        """
+        Press and release the given keys.
+        """
+        hotkey_sequences = [
+            self._get_keycode(key) for key in keys if self._get_keycode(key) is not None
+        ]
+        command_args = [f"{keycode}:1" for keycode in hotkey_sequences] + [
+            f"{keycode}:0" for keycode in hotkey_sequences[::-1]
+        ]
+        self._run_ydotool(["key", *command_args], count=count)

oagi/handler/ydotool_action_handler.py

@@ -0,0 +1,226 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+import time
+
+from pydantic import BaseModel, Field
+
+from ..types import Action, ActionType, parse_coords, parse_drag_coords, parse_scroll
+from .capslock_manager import CapsLockManager
+from .wayland_support import Ydotool, get_screen_size
+
+
+class YdotoolConfig(BaseModel):
+    """Configuration for YdotoolActionHandler."""
+
+    scroll_amount: int = Field(
+        default=20,
+        description="Amount to scroll (positive for up, negative for down)",
+    )
+    wait_duration: float = Field(
+        default=1.0, description="Duration for wait actions in seconds"
+    )
+    action_pause: float = Field(
+        default=0.5, description="Pause between Ydotool actions in seconds"
+    )
+    capslock_mode: str = Field(
+        default="session",
+        description="Caps lock handling mode: 'session' (internal state) or 'system' (OS-level)",
+    )
+    socket_address: str = Field(
+        default="",
+        description="Custom socket address for ydotool (e.g., '/tmp/ydotool.sock')",
+    )
+
+
+class YdotoolActionHandler(Ydotool):
+    def __init__(self, config: YdotoolConfig | None = None) -> None:
+        """
+        Handles actions to be executed using Ydotool.
+
+        This class provides functionality for handling and executing a sequence of
+        actions using the Ydotool. It processes a list of actions and executes
+        them as per the implementation.
+
+        Methods:
+            __call__: Executes the provided list of actions.
+
+        Args:
+            actions (list[Action]): List of actions to be processed and executed.
+        """
+        # Use default config if none provided
+        self.config = config or YdotoolConfig()
+        super().__init__(socket_address=self.config.socket_address)
+        # Get screen dimensions for coordinate denormalization
+        self.screen_width, self.screen_height = get_screen_size()
+        # Set default delay between actions
+        self.action_pause = self.config.action_pause
+        # Initialize caps lock manager
+        self.caps_manager = CapsLockManager(mode=self.config.capslock_mode)
+
+    def reset(self):
+        """Reset handler state.
+
+        Called at automation start/end and when FINISH action is received.
+        Resets the internal capslock state.
+        """
+        self.caps_manager.reset()
+
+    def _execute_action(self, action: Action) -> bool:
+        """
+        Execute a group of actions and return whether FINISH is reached.
+        """
+        finished = False
+        arg = (action.argument or "").strip()
+        count = int(action.count or 1)
+
+        match action.type:
+            case ActionType.DRAG:
+                x1, y1, x2, y2 = self._parse_drag_coords(arg)
+                self.drag(x1, y1, x2, y2, count=count)
+
+            case ActionType.SCROLL:
+                x, y, direction = self._parse_scroll(arg)
+                scroll_amount = (
+                    self.config.scroll_amount
+                    if direction == "up"
+                    else -self.config.scroll_amount
+                )
+                self.scroll(scroll_amount)
+
+            case ActionType.RIGHT_SINGLE:
+                x, y = self._parse_coords(arg)
+                self.click(x, y, right=True, count=count)
+
+            case ActionType.LEFT_DOUBLE:
+                x, y = self._parse_coords(arg)
+                self.click(x, y, count=2 * count)
+
+            case ActionType.LEFT_TRIPLE:
+                x, y = self._parse_coords(arg)
+                self.click(x, y, count=3 * count)
+
+            case ActionType.CLICK:
+                x, y = self._parse_coords(arg)
+                self.click(x, y, count=count)
+
+            case ActionType.HOTKEY:
+                keys = self._parse_hotkey(arg)
+                # Check if this is a caps lock key press
+                if len(keys) == 1 and keys[0] == "capslock":
+                    if self.caps_manager.should_use_system_capslock():
+                        # System mode: use OS-level caps lock
+                        self.hotkey(["capslock"])
+                    else:
+                        # Session mode: toggle internal state
+                        self.caps_manager.toggle()
+                else:
+                    # Regular hotkey combination
+                    self.hotkey(keys, count=count)
+
+            case ActionType.TYPE:
+                # Remove quotes if present
+                text = arg.strip("\"'")
+                # Apply caps lock transformation if needed
+                text = self.caps_manager.transform_text(text)
+                self._run_ydotool(["type", text], count=count)
+
+            case ActionType.FINISH:
+                # Task completion - reset handler state
+                self.reset()
+
+            case ActionType.WAIT:
+                # Wait for a short period
+                time.sleep(self.config.wait_duration)
+
+            case ActionType.CALL_USER:
+                # Call user - implementation depends on requirements
+                print("User intervention requested")
+
+            case _:
+                print(f"Unknown action type: {action.type}")
+
+        return finished
+
+    def _denormalize_coords(self, x: float, y: float) -> tuple[int, int]:
+        """Convert coordinates from 0-1000 range to actual screen coordinates.
+
+        Also handles corner coordinates to prevent PyAutoGUI fail-safe trigger.
+        Corner coordinates (0,0), (0,max), (max,0), (max,max) are offset by 1 pixel.
+        """
+        screen_x = int(x * self.screen_width / 1000)
+        screen_y = int(y * self.screen_height / 1000)
+
+        # Prevent fail-safe by adjusting corner coordinates
+        # Check if coordinates are at screen corners (with small tolerance)
+        if screen_x < 1:
+            screen_x = 1
+        elif screen_x > self.screen_width - 1:
+            screen_x = self.screen_width - 1
+
+        if screen_y < 1:
+            screen_y = 1
+        elif screen_y > self.screen_height - 1:
+            screen_y = self.screen_height - 1
+
+        return screen_x, screen_y
+
+    def _normalize_key(self, key: str) -> str:
+        """Normalize key names for consistency."""
+        key = key.strip().lower()
+        # Normalize caps lock variations
+        hotkey_variations_mapping = {
+            "capslock": ["caps_lock", "caps", "capslock"],
+            "pgup": ["page_up", "pageup"],
+            "pgdn": ["page_down", "pagedown"],
+        }
+        for normalized, variations in hotkey_variations_mapping.items():
+            if key in variations:
+                return normalized
+        return key
+
+    def _parse_coords(self, args_str: str) -> tuple[int, int]:
+        """Extract x, y coordinates from argument string."""
+        coords = parse_coords(args_str)
+        if not coords:
+            raise ValueError(f"Invalid coordinates format: {args_str}")
+        return self._denormalize_coords(coords[0], coords[1])
+
+    def _parse_drag_coords(self, args_str: str) -> tuple[int, int, int, int]:
+        """Extract x1, y1, x2, y2 coordinates from drag argument string."""
+        coords = parse_drag_coords(args_str)
+        if not coords:
+            raise ValueError(f"Invalid drag coordinates format: {args_str}")
+        x1, y1 = self._denormalize_coords(coords[0], coords[1])
+        x2, y2 = self._denormalize_coords(coords[2], coords[3])
+        return x1, y1, x2, y2
+
+    def _parse_scroll(self, args_str: str) -> tuple[int, int, str]:
+        """Extract x, y, direction from scroll argument string."""
+        result = parse_scroll(args_str)
+        if not result:
+            raise ValueError(f"Invalid scroll format: {args_str}")
+        x, y = self._denormalize_coords(result[0], result[1])
+        return x, y, result[2]
+
+    def _parse_hotkey(self, args_str: str) -> list[str]:
+        """Parse hotkey string into list of keys."""
+        # Remove parentheses if present
+        args_str = args_str.strip("()")
+        # Split by '+' to get individual keys
+        keys = [self._normalize_key(key) for key in args_str.split("+")]
+        return keys
+
+    def __call__(self, actions: list[Action]) -> None:
+        """Execute the provided list of actions."""
+        for action in actions:
+            try:
+                self._execute_action(action)
+            except Exception as e:
+                print(f"Error executing action {action.type}: {e}")
+                raise

oagi/platform_info.py

@@ -0,0 +1,51 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+"""Platform information and SDK headers for analytics."""
+
+import platform
+import sys
+from importlib.metadata import version
+
+SDK_NAME = "oagi-python"
+
+
+def get_sdk_version() -> str:
+    """Get the SDK version from package metadata."""
+    try:
+        return version("oagi-core")
+    except Exception:
+        return "unknown"
+
+
+def get_user_agent() -> str:
+    """Build User-Agent string.
+
+    Example: oagi-python/0.12.1 (python 3.11.5; darwin; arm64)
+    """
+    return (
+        f"{SDK_NAME}/{get_sdk_version()} "
+        f"(python {platform.python_version()}; {sys.platform}; {platform.machine()})"
+    )
+
+
+def get_sdk_headers() -> dict[str, str]:
+    """Get SDK headers for API requests.
+
+    Returns headers for both debugging (User-Agent) and structured analytics
+    (x-sdk-* headers).
+    """
+    return {
+        "User-Agent": get_user_agent(),
+        "x-sdk-name": SDK_NAME,
+        "x-sdk-version": get_sdk_version(),
+        "x-sdk-language": "python",
+        "x-sdk-language-version": platform.python_version(),
+        "x-sdk-os": sys.platform,
+        "x-sdk-platform": platform.machine(),
+    }

{oagi_core-0.12.0.dist-info → oagi_core-0.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.12.0
+Version: 0.13.0
 Summary: Official API of OpenAGI Foundation
 Project-URL: Homepage, https://github.com/agiopen-org/oagi
 Author-email: OpenAGI Foundation <contact@agiopen.org>
@@ -35,6 +35,7 @@ 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'
 Requires-Dist: pyobjc-framework-quartz>=8.0; (sys_platform == 'darwin') and extra == 'desktop'
+Requires-Dist: screeninfo>=0.8.1; extra == 'desktop'
 Provides-Extra: server
 Requires-Dist: fastapi[standard]>=0.100.0; extra == 'server'
 Requires-Dist: pydantic-settings>=2.0.0; extra == 'server'
@@ -82,6 +83,7 @@ With Lux, possibilities are endless. Here are a few examples:
   - [Command Line Interface](#command-line-interface)
   - [Image Processing](#image-processing)
   - [Manual Control with Actor](#manual-control-with-actor)
+  - [Run On System With Wayland](#run-on-system-with-wayland)
 - [Examples](#examples)
 - [Socket.IO Server (Optional)](#socketio-server-optional)
   - [Installation](#installation-1)
@@ -239,6 +241,45 @@ async def main():
 asyncio.run(main())
 ```
 
+### Run On System With Wayland
+The SDK includes support for desktop automation on systems with Wayland display, such as Ubuntu/Debain. It leverages `ydotool` and `flameshot` for mouse/keyboard actions and screenshot capture respectively. Please install these two tools on your system in advance and ensure `ydotoold` server is running in the background when running the script.
+
+Refer to [ydotool](https://github.com/ReimuNotMoe/ydotool) and [flameshot](https://flameshot.org/#download) for installation instructions. Disable mouse acceleration for more precise mouse control. (In GNOME, run `gsettings set org.gnome.desktop.peripherals.mouse accel-profile 'flat'`)
+
+Run tasks automatically with screenshot capture and action execution:
+```python
+import asyncio
+from oagi import AsyncDefaultAgent, AsyncYdotoolActionHandler, AsyncScreenshotMaker
+
+async def main():
+    agent = AsyncDefaultAgent(max_steps=10)
+    completed = await agent.execute(
+        "Search weather on Google",
+        action_handler=AsyncYdotoolActionHandler(),    # Executes mouse/keyboard actions, based on 'ydotool'
+        image_provider=AsyncScreenshotMaker(),         # Captures screenshots, based on 'flameshot'
+    )
+    return completed
+
+asyncio.run(main())
+```
+
+Configure Ydotool behavior with custom settings:
+
+```python
+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)
+    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)
+)
+
+action_handler = AsyncYdotoolActionHandler(config=config)
+```
+
 ## Examples
 
 See the [`examples/`](examples/) directory for more usage patterns:

{oagi_core-0.12.0.dist-info → oagi_core-0.13.0.dist-info}/RECORD

@@ -1,7 +1,8 @@
-oagi/__init__.py,sha256=hKfGbbvYFNoc8LsTd34aM6Uj-nGEJ0J8JbceXZP5xZ0,4801
+oagi/__init__.py,sha256=ly956qE0F4FlzaU-kPsKAhpG2Kc3D9T_BJDZmWqioOc,5616
 oagi/constants.py,sha256=ywyMimjh15tC5p4MBZjkJIqOVElPRS50iJtrPE3VClw,1211
 oagi/exceptions.py,sha256=Rco37GQTPYUfc2vRO3hozxPF_s8mKFDpFvBg2UKWo3Y,3066
 oagi/logging.py,sha256=YT3KCMFj5fzO98R9xlDDgfSotUuz1xRD6OZeYM2rKoo,1760
+oagi/platform_info.py,sha256=GEqNWnwePszVEM21toGGi07o3PaX8O059CYRr0RUM_M,1424
 oagi/actor/__init__.py,sha256=g_8_7ZLDLKuCGzyrB42OzY3gSOjd_SxzkJW3_pf-PXs,662
 oagi/actor/async_.py,sha256=DcU6ifAcrYI1GSrTFgMPrWhikjmnJfZVaFsun15DG_k,3768
 oagi/actor/async_short.py,sha256=QSo67aPsd_rxA2J2TR1fv6nJD6wO00q3S-QQYNK93q4,2821
@@ -9,7 +10,7 @@ oagi/actor/base.py,sha256=UUZdS1tufZDIbtQHLs-es6ptGHQpa-EPWf7RSbVpQnU,7921
 oagi/actor/short.py,sha256=wKLCxvf7Ys6rYxXpHe4zbZdbf_1q1qcmm5WyWubwj3E,2630
 oagi/actor/sync.py,sha256=QTY1WNTI75jwkWBghdVViHIp5rYkbm3kumlLedU8YeQ,3588
 oagi/agent/__init__.py,sha256=KTVLUMhbjgpTJoOWMUZkkiqwhgumvbOZV2tJ9XCLfao,901
-oagi/agent/default.py,sha256=YKAAq_XJrM-YpYuLtDtEH9XA502eijsdiawQKAf4iJ0,4709
+oagi/agent/default.py,sha256=Ax05kBa8Fb14Ev8wd9LS6xkF65grf6qdxxTlgpkkDuk,4715
 oagi/agent/factories.py,sha256=syi_EOlU4SUjo-0CKaML8eIPu3ToUEKua2VHp9lvNF0,5839
 oagi/agent/protocol.py,sha256=IQJGiMN4yZIacrh5e9JQsoM9TyHb8wJRQR4LAk8dSA0,1615
 oagi/agent/registry.py,sha256=7bMA2-pH3xQ9ZavrHB_mnc2fOGSMeICPbOGtHoM7It0,4851
@@ -23,28 +24,33 @@ oagi/agent/tasker/__init__.py,sha256=1iTEFe7lzcqh96TL9R0QADPpLJLrUP0shtZ4DlZSv_8
 oagi/agent/tasker/memory.py,sha256=NR13l5yxRA8GUE-oupAP4W1n80ZNG0SxpUfxsNltkUY,5033
 oagi/agent/tasker/models.py,sha256=sMQgwIMKhT1tvVF2yoc1hh8GwEiJ6i6qPMy9WoiA8JM,2137
 oagi/agent/tasker/planner.py,sha256=q6IvH6sfU2kYX1NcC9VHjGaQ0X9jF18yjuAYXisNCg0,15489
-oagi/agent/tasker/taskee_agent.py,sha256=VquuEkkjpLYOVPamHDz53e9GClj6v93VPMHoiNmR8-U,18084
-oagi/agent/tasker/tasker_agent.py,sha256=kbWvvRVS12S8eFd0PRszFrcSSWRzz_f6Jd7LuaRcwJQ,11285
+oagi/agent/tasker/taskee_agent.py,sha256=OugYJbTbFKxgNjbIyQBBH4Zm5u5PuWN1F6R81_eIro8,18090
+oagi/agent/tasker/tasker_agent.py,sha256=yb0BdQzJyAPpK3njHPWgQruV8zpUGBXn1WjOGEMIO-g,11291
 oagi/cli/__init__.py,sha256=aDnJViTseShpo5fdGPTj-ELysZhmdvB6Z8mEj2D-_N4,359
-oagi/cli/agent.py,sha256=fd7WtR5zoRJmyHDr67zfBvEX-_BLIjPbBqp-dhy4AAk,11061
+oagi/cli/agent.py,sha256=lT95jgfzf-LizOWbzYfhq_EkcYcLvJH2uL-HKnYW_es,11533
 oagi/cli/display.py,sha256=Y8_Dn5RIEfRqZUHVGF6URItW0C3XC7bPLWoAmmhvBS0,1829
 oagi/cli/main.py,sha256=faHns0HaQCGyylDn2YZLpjQESuEiMYjoQVoMkt8FsH4,2292
 oagi/cli/server.py,sha256=JFpzCOeaftITxesz8Ya-_Efs03bgotBg7aYwmMZhPwU,3033
 oagi/cli/tracking.py,sha256=TdrAcNq_-OjgXltFCoFc8NsO_k6yHbdzHnMn3vAAvKA,1707
 oagi/cli/utils.py,sha256=zIkTrr-ai__3cGSaxiXY-OJs69Fcxd1sHb2FoeyHFtE,3034
 oagi/client/__init__.py,sha256=F9DShPUdb6vZYmN1fpM1VYzp4MWqUao_e_R1KYmM4Q4,410
-oagi/client/async_.py,sha256=m7hkJSebH2MyXAwEbpsFw0UQm6aRJQ8HZiULBlZxvM4,9385
-oagi/client/base.py,sha256=kKkdpd-YkjFfTVCOQzVRjjkQnCpH2hZLtyM1vKizy6I,14693
-oagi/client/sync.py,sha256=-wtaW1H5jgj32_1TDVxMO7zdZ47ZV6ZG7a6jF2ztbv0,9158
-oagi/handler/__init__.py,sha256=vEUvyiUvTRf1GE4vTiz_bQjLv3psdmHyt0mfKJHq24M,1247
+oagi/client/async_.py,sha256=BANE0KU14WBuXp6suBhr8JSlpWhN5SR2aJJ7wAJBDLQ,9574
+oagi/client/base.py,sha256=CWAvE0AcpL8HD_i00n7Fq53AIAQGhBhS_n6LifUCqxE,14736
+oagi/client/sync.py,sha256=4xNqqNihXmgLU385h22mMJ9wmmlw-jeOdWI4fmpEpTk,9369
+oagi/handler/__init__.py,sha256=rqxbj6Bp9MGndLBVhqRx8b-GSYR3PC5ktErMvd-HzRI,2397
 oagi/handler/_macos.py,sha256=Gs8GrhA_WAyv9Yw0D41duliP32Xk6vouyMeWjWJJT90,5187
 oagi/handler/_windows.py,sha256=MSgPDYEOetSjbn9eJDSrdzBVlUGgGsTlegaTDc4C4Ss,2828
+oagi/handler/_ydotool.py,sha256=WjvE6RGRm8j3SEWpgfMw31aow3z3qkiMupuUHYt-QAM,2948
 oagi/handler/async_pyautogui_action_handler.py,sha256=wfNRBBURZnwQkNTcs9OPMmFJIAPtnXmcqxWbjda_q7I,1863
 oagi/handler/async_screenshot_maker.py,sha256=8QCtUV59ozpOpvkqhUMb8QDI2qje2gsoFT1qB60tfJM,1689
+oagi/handler/async_ydotool_action_handler.py,sha256=BRGqZB2u1k7R1acUX9k0TfdrmWS2eh3opc8LoqnlwJ4,1848
 oagi/handler/capslock_manager.py,sha256=40LzWt1_1wbncF5koUTdbd9V3eo5Ex_mEWwjtEmHAf4,1878
-oagi/handler/pil_image.py,sha256=yUcAoGBL-aZ0PCjSaAmQsDwtyzjldXHqXQp_OYRk6e4,4080
+oagi/handler/pil_image.py,sha256=GQw2o8ORQinrM3AxhgNBbLhrkZajOL8YagU7UF-kkes,4357
 oagi/handler/pyautogui_action_handler.py,sha256=BVmpKuYAMINJ5Ue_PK_WxFScAqLeyXC64g4NWQUtG_M,10146
 oagi/handler/screenshot_maker.py,sha256=j1jTW-awx3vAnb1N5_FIMBC0Z-rNVQbiBP-S6Gh5dlE,1284
+oagi/handler/utils.py,sha256=jj10z-v4_LUuVb8aClyXkUfZVEaqsWgi3be4t3Gw7oI,697
+oagi/handler/wayland_support.py,sha256=jeQDqpwAxxREaGAYePQuK14nuEMPGmMEvMz2ymS-rT4,7727
+oagi/handler/ydotool_action_handler.py,sha256=8cmOFaEsYMI5BiYdYRuUIaSXDNgrdk-B3OnHVbEa9Sk,8608
 oagi/server/__init__.py,sha256=uZx8u3vJUb87kkNzwmmVrgAgbqRu0WxyMIQCLSx56kk,452
 oagi/server/agent_wrappers.py,sha256=j8va0A7u80bzOM82nndAplK1uaO_T3kufHWScK6kfWM,3263
 oagi/server/config.py,sha256=AJ1PLKuxrc6pRuur1hm5DwG2g2otxPwOCfKgzIACkSk,1691
@@ -69,8 +75,8 @@ oagi/types/models/step.py,sha256=RSI4H_2rrUBq_xyCoWKaq7JHdJWNobtQppaKC1l0aWU,471
 oagi/utils/__init__.py,sha256=vHXyX66hEsf33OJJkmZSUjaTYU0UngfbtjcZgxfOj3A,441
 oagi/utils/output_parser.py,sha256=U7vzmoD8pyzDg23z3vy-L9a_jKPsAlr3x8lIdPszrY8,5322
 oagi/utils/prompt_builder.py,sha256=_Q1HY82YUrq3jSCTZ3Rszu3qmI3Wn_fmq8hf14NuwQM,2180
-oagi_core-0.12.0.dist-info/METADATA,sha256=a8SJt-skg0xQjodJEqwLd0EOJzhw8BrHBUIqlYGEf1Y,12176
-oagi_core-0.12.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-oagi_core-0.12.0.dist-info/entry_points.txt,sha256=zzgsOSWX6aN3KUB0Z1it8DMxFFBJBqmZVqMVAJRjYuw,44
-oagi_core-0.12.0.dist-info/licenses/LICENSE,sha256=sy5DLA2M29jFT4UfWsuBF9BAr3FnRkYtnAu6oDZiIf8,1075
-oagi_core-0.12.0.dist-info/RECORD,,
+oagi_core-0.13.0.dist-info/METADATA,sha256=ZndadhpFZ4R5JEvm6O3jA_7zc8c2K0evAJRN_zaGa1I,14203
+oagi_core-0.13.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+oagi_core-0.13.0.dist-info/entry_points.txt,sha256=zzgsOSWX6aN3KUB0Z1it8DMxFFBJBqmZVqMVAJRjYuw,44
+oagi_core-0.13.0.dist-info/licenses/LICENSE,sha256=sy5DLA2M29jFT4UfWsuBF9BAr3FnRkYtnAu6oDZiIf8,1075
+oagi_core-0.13.0.dist-info/RECORD,,