oagi-core 0.9.2__tar.gz → 0.10.1__tar.gz

{oagi_core-0.9.2 → oagi_core-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.9.2
+Version: 0.10.1
 Summary: Official API of OpenAGI Foundation
 Project-URL: Homepage, https://github.com/agiopen-org/oagi
 Author-email: OpenAGI Foundation <contact@agiopen.org>
@@ -32,6 +32,7 @@ Requires-Dist: rich>=13.0.0
 Provides-Extra: desktop
 Requires-Dist: pillow>=11.3.0; extra == 'desktop'
 Requires-Dist: pyautogui>=0.9.54; extra == 'desktop'
+Requires-Dist: pyobjc-framework-applicationservices>=9.0; (sys_platform == 'darwin') and extra == 'desktop'
 Requires-Dist: pyobjc-framework-quartz>=9.0; (sys_platform == 'darwin') and extra == 'desktop'
 Provides-Extra: server
 Requires-Dist: fastapi[standard]>=0.115.0; extra == 'server'
@@ -73,8 +74,8 @@ pip install oagi-core[server]   # Server support
 
 Set your API credentials:
 ```bash
-export OAGI_API_KEY="your-api-key"
-export OAGI_BASE_URL="https://api.oagi.com"  # or your server URL
+export OAGI_API_KEY="your-api-key" # get your API key from https://developer.openagi.org/
+# export OAGI_BASE_URL="https://api.agiopen.org/", # optional, defaults to production endpoint
 ```
 
 ### Automated Task Execution
@@ -82,21 +83,25 @@ export OAGI_BASE_URL="https://api.oagi.com"  # or your server URL
 Run tasks automatically with screenshot capture and action execution:
 
 ```python
-from oagi import ShortTask, ScreenshotMaker, PyautoguiActionHandler
-
-task = ShortTask()
-completed = task.auto_mode(
-    "Search weather on Google",
-    max_steps=10,
-    executor=PyautoguiActionHandler(),  # Executes mouse/keyboard actions
-    image_provider=ScreenshotMaker(),    # Captures screenshots
-)
+import asyncio
+from oagi import AsyncDefaultAgent, AsyncPyautoguiActionHandler, AsyncScreenshotMaker
+
+async def main():
+    agent = AsyncDefaultAgent(max_steps=10)
+    completed = await agent.execute(
+        "Search weather on Google",
+        action_handler=AsyncPyautoguiActionHandler(),  # Executes mouse/keyboard actions
+        image_provider=AsyncScreenshotMaker(),         # Captures screenshots
+    )
+    return completed
+
+asyncio.run(main())
 ```
 
 Configure PyAutoGUI behavior with custom settings:
 
 ```python
-from oagi import PyautoguiActionHandler, PyautoguiConfig
+from oagi import AsyncPyautoguiActionHandler, PyautoguiConfig
 
 # Customize action behavior
 config = PyautoguiConfig(
@@ -108,8 +113,7 @@ config = PyautoguiConfig(
     capslock_mode="session" # Caps lock mode: 'session' or 'system' (default: 'session')
 )
 
-executor = PyautoguiActionHandler(config=config)
-task.auto_mode("Complete form", executor=executor, image_provider=ScreenshotMaker())
+action_handler = AsyncPyautoguiActionHandler(config=config)
 ```
 
 ### Image Processing
@@ -130,20 +134,28 @@ config = ImageConfig(
 compressed = image.transform(config)
 ```
 
-### Async Support
+### Manual Control with Actor
 
-Use async client for non-blocking operations and better concurrency:
+For step-by-step control over task execution:
 
 ```python
 import asyncio
-from oagi import AsyncShortTask
+from oagi import AsyncActor, AsyncPyautoguiActionHandler, AsyncScreenshotMaker
 
 async def main():
-    # Async task automation
-    task = AsyncShortTask()
-    async with task:
-        await task.init_task("Complete the form")
-        # ... continue with async operations
+    async with AsyncActor() as actor:
+        await actor.init_task("Complete the form")
+        image_provider = AsyncScreenshotMaker()
+        action_handler = AsyncPyautoguiActionHandler()
+
+        for _ in range(10):
+            image = await image_provider()
+            step = await actor.step(image)
+
+            if step.stop:
+                break
+
+            await action_handler(step.actions)
 
 asyncio.run(main())
 ```
@@ -151,9 +163,10 @@ asyncio.run(main())
 ## Examples
 
 See the [`examples/`](examples/) directory for more usage patterns:
-- `google_weather.py` - Basic task execution with `ShortTask`
+- `execute_task_auto.py` - Automated task execution with `AsyncDefaultAgent`
+- `execute_task_manual.py` - Manual step-by-step control with `Actor`
+- `continued_session.py` - Continuing tasks across sessions
 - `screenshot_with_config.py` - Image compression and optimization
-- `execute_task_auto.py` - Automated task execution
 - `socketio_server_basic.py` - Socket.IO server example
 - `socketio_client_example.py` - Socket.IO client implementation
 

{oagi_core-0.9.2 → oagi_core-0.10.1}/README.md

@@ -31,8 +31,8 @@ pip install oagi-core[server]   # Server support
 
 Set your API credentials:
 ```bash
-export OAGI_API_KEY="your-api-key"
-export OAGI_BASE_URL="https://api.oagi.com"  # or your server URL
+export OAGI_API_KEY="your-api-key" # get your API key from https://developer.openagi.org/
+# export OAGI_BASE_URL="https://api.agiopen.org/", # optional, defaults to production endpoint
 ```
 
 ### Automated Task Execution
@@ -40,21 +40,25 @@ export OAGI_BASE_URL="https://api.oagi.com"  # or your server URL
 Run tasks automatically with screenshot capture and action execution:
 
 ```python
-from oagi import ShortTask, ScreenshotMaker, PyautoguiActionHandler
-
-task = ShortTask()
-completed = task.auto_mode(
-    "Search weather on Google",
-    max_steps=10,
-    executor=PyautoguiActionHandler(),  # Executes mouse/keyboard actions
-    image_provider=ScreenshotMaker(),    # Captures screenshots
-)
+import asyncio
+from oagi import AsyncDefaultAgent, AsyncPyautoguiActionHandler, AsyncScreenshotMaker
+
+async def main():
+    agent = AsyncDefaultAgent(max_steps=10)
+    completed = await agent.execute(
+        "Search weather on Google",
+        action_handler=AsyncPyautoguiActionHandler(),  # Executes mouse/keyboard actions
+        image_provider=AsyncScreenshotMaker(),         # Captures screenshots
+    )
+    return completed
+
+asyncio.run(main())
 ```
 
 Configure PyAutoGUI behavior with custom settings:
 
 ```python
-from oagi import PyautoguiActionHandler, PyautoguiConfig
+from oagi import AsyncPyautoguiActionHandler, PyautoguiConfig
 
 # Customize action behavior
 config = PyautoguiConfig(
@@ -66,8 +70,7 @@ config = PyautoguiConfig(
     capslock_mode="session" # Caps lock mode: 'session' or 'system' (default: 'session')
 )
 
-executor = PyautoguiActionHandler(config=config)
-task.auto_mode("Complete form", executor=executor, image_provider=ScreenshotMaker())
+action_handler = AsyncPyautoguiActionHandler(config=config)
 ```
 
 ### Image Processing
@@ -88,20 +91,28 @@ config = ImageConfig(
 compressed = image.transform(config)
 ```
 
-### Async Support
+### Manual Control with Actor
 
-Use async client for non-blocking operations and better concurrency:
+For step-by-step control over task execution:
 
 ```python
 import asyncio
-from oagi import AsyncShortTask
+from oagi import AsyncActor, AsyncPyautoguiActionHandler, AsyncScreenshotMaker
 
 async def main():
-    # Async task automation
-    task = AsyncShortTask()
-    async with task:
-        await task.init_task("Complete the form")
-        # ... continue with async operations
+    async with AsyncActor() as actor:
+        await actor.init_task("Complete the form")
+        image_provider = AsyncScreenshotMaker()
+        action_handler = AsyncPyautoguiActionHandler()
+
+        for _ in range(10):
+            image = await image_provider()
+            step = await actor.step(image)
+
+            if step.stop:
+                break
+
+            await action_handler(step.actions)
 
 asyncio.run(main())
 ```
@@ -109,9 +120,10 @@ asyncio.run(main())
 ## Examples
 
 See the [`examples/`](examples/) directory for more usage patterns:
-- `google_weather.py` - Basic task execution with `ShortTask`
+- `execute_task_auto.py` - Automated task execution with `AsyncDefaultAgent`
+- `execute_task_manual.py` - Manual step-by-step control with `Actor`
+- `continued_session.py` - Continuing tasks across sessions
 - `screenshot_with_config.py` - Image compression and optimization
-- `execute_task_auto.py` - Automated task execution
 - `socketio_server_basic.py` - Socket.IO server example
 - `socketio_client_example.py` - Socket.IO client implementation
 

oagi_core-0.10.1/examples/execute_task_auto.py

@@ -0,0 +1,37 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+import asyncio
+
+from oagi import (
+    AsyncDefaultAgent,
+    AsyncPyautoguiActionHandler,
+    AsyncScreenshotMaker,
+)
+
+
+def execute_task_auto(task_desc, max_steps=5):
+    """Synchronous wrapper for async task execution."""
+    return asyncio.run(async_execute_task_auto(task_desc, max_steps))
+
+
+async def async_execute_task_auto(task_desc, max_steps=5):
+    # 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()
+
+    is_completed = await agent.execute(
+        task_desc,
+        action_handler=action_handler,
+        image_provider=image_provider,
+    )
+
+    return is_completed, await image_provider.last_image()

{oagi_core-0.9.2 → oagi_core-0.10.1}/examples/google_weather.py

@@ -9,7 +9,7 @@
 from examples.execute_task_manual import execute_task_manual
 
 is_completed, screenshot = execute_task_manual(
-    desc := "Search weather with Google", max_steps=5
+    desc := "Search weather with Google", max_steps=10
 )
 
 print(f"is_completed: {is_completed}, desc: {desc}")

oagi_core-0.10.1/examples/tasker_agent_example.py

@@ -0,0 +1,73 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+import asyncio
+import os
+import traceback
+
+from oagi import (
+    AsyncAgentObserver,
+    AsyncPyautoguiActionHandler,
+    AsyncScreenshotMaker,
+    TaskerAgent,
+)
+
+
+async def main():
+    # Create observer for recording execution history
+    observer = AsyncAgentObserver()
+
+    # Initialize the tasker agent
+    # Note: Ensure OAGI_API_KEY and OAGI_BASE_URL environment variables are set
+    tasker = TaskerAgent(
+        api_key=os.getenv("OAGI_API_KEY"),
+        base_url=os.getenv("OAGI_BASE_URL", "https://api.agiopen.org"),
+        model="lux-actor-1",
+        max_steps=30,
+        temperature=0.5,
+        step_observer=observer,
+    )
+
+    # Define the task with multiple todos
+    task_description = "Open a web browser and search for information about Python"
+
+    # Break down into specific todos
+    todos = [
+        "Search for 'Python programming language'",
+        "Click on the official Python.org website link",
+    ]
+
+    # Set the task
+    tasker.set_task(
+        task=task_description,
+        todos=todos,
+    )
+
+    image_provider = AsyncScreenshotMaker()
+    action_handler = AsyncPyautoguiActionHandler()
+
+    try:
+        # Execute the task
+        success = await tasker.execute(
+            instruction="",
+            action_handler=action_handler,
+            image_provider=image_provider,
+        )
+        print(f"Tasker success: {success}")
+
+    except Exception as e:
+        print(f"\nError during execution: {e}")
+        traceback.print_exc()
+
+    observer.export("html", export_file := "export.html")
+    print(f"\nExecution history exported: {export_file}")
+
+
+if __name__ == "__main__":
+    # Run the async main function
+    asyncio.run(main())

{oagi_core-0.9.2 → oagi_core-0.10.1}/metapackage/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi"
-version = "0.9.2"
+version = "0.10.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.9.2",
+    "oagi-core[desktop,server]==0.10.1",
 ]
 
 [project.urls]

{oagi_core-0.9.2 → oagi_core-0.10.1}/metapackage/uv.lock

@@ -106,7 +106,7 @@ name = "exceptiongroup"
 version = "1.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/0b/9f/a65090624ecf468cdca03533906e7c69ed7588582240cfe7cc9e770b50eb/exceptiongroup-1.3.0.tar.gz", hash = "sha256:b241f5885f560bc56a59ee63ca4c6a8bfa46ae4ad651af316d4e81817bb9fd88", size = 29749, upload-time = "2025-05-10T17:42:51.123Z" }
 wheels = [
@@ -397,33 +397,34 @@ sdist = { url = "https://files.pythonhosted.org/packages/28/fa/b2ba8229b9381e8f6
 
 [[package]]
 name = "oagi"
-version = "0.9.2"
+version = "0.10.1"
 source = { editable = "." }
 dependencies = [
     { name = "oagi-core", extra = ["desktop", "server"] },
 ]
 
 [package.metadata]
-requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.9.1" }]
+requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.10.0" }]
 
 [[package]]
 name = "oagi-core"
-version = "0.9.1"
+version = "0.10.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "pydantic" },
     { name = "rich" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/8c/f5/e7782e86376068d5ce46e746da96dd6692f73aaaa3440cc0b403ff23824c/oagi_core-0.9.1.tar.gz", hash = "sha256:7885e527c4c80121ec946c34f49798948d8df80be6924c79885a219b8ef88330", size = 164972, upload-time = "2025-11-13T17:18:01.912Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/2d/3f/6fa48d2d207051d5f3a8eedf8f7d9cd97f7463746f6578b6655511a4cf47/oagi_core-0.10.0.tar.gz", hash = "sha256:d50c6dac28eb4d395e6910bd24cf412845ffbad25c1be7a2a6a04511691470e9", size = 259893, upload-time = "2025-11-24T04:15:08.503Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/80/5c/a5ba4897bf8522659de7ef379e504c29de1cda4cc0b4fc72a5224a9c00aa/oagi_core-0.9.1-py3-none-any.whl", hash = "sha256:fdb1a880b632911075c7f9ff92493d139ebbc2fd66b4eba6aef7e6798f2c0e3e", size = 74337, upload-time = "2025-11-13T17:18:00.537Z" },
+    { url = "https://files.pythonhosted.org/packages/44/9f/582af4d42c1074fe647a3fdbdaddb0bd7b4402ac85e42ea9dcfdf7b52528/oagi_core-0.10.0-py3-none-any.whl", hash = "sha256:f7e19c744586dfb22cfcef0ddc031a457ad4605e6441198cdc6bc4f27bebbb1a", size = 83329, upload-time = "2025-11-24T04:15:07.201Z" },
 ]
 
 [package.optional-dependencies]
 desktop = [
     { name = "pillow" },
     { name = "pyautogui" },
+    { name = "pyobjc-framework-quartz", marker = "sys_platform == 'darwin'" },
 ]
 server = [
     { name = "fastapi", extra = ["standard"] },

{oagi_core-0.9.2 → oagi_core-0.10.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi-core"
-version = "0.9.2"
+version = "0.10.1"
 description = "Official API of OpenAGI Foundation"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -31,6 +31,7 @@ desktop = [
     "pillow>=11.3.0",
     "pyautogui>=0.9.54",
     "pyobjc-framework-Quartz>=9.0; sys_platform == 'darwin'",
+    "pyobjc-framework-ApplicationServices>=9.0; sys_platform == 'darwin'",
 ]
 server = [
     "fastapi[standard]>=0.115.0",

oagi_core-0.10.1/src/oagi/__init__.py

@@ -0,0 +1,148 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+import importlib
+from typing import TYPE_CHECKING
+
+from oagi.client import AsyncClient, SyncClient
+from oagi.exceptions import (
+    APIError,
+    AuthenticationError,
+    ConfigurationError,
+    NetworkError,
+    NotFoundError,
+    OAGIError,
+    RateLimitError,
+    RequestTimeoutError,
+    ServerError,
+    ValidationError,
+    check_optional_dependency,
+)
+from oagi.task import Actor, AsyncActor, AsyncShortTask, AsyncTask, ShortTask, Task
+from oagi.types import ImageConfig
+from oagi.types.models import (
+    ErrorDetail,
+    ErrorResponse,
+    GenerateResponse,
+    LLMResponse,
+    UploadFileResponse,
+)
+
+# Lazy imports for optional dependency modules
+# Format: name -> (module_path, package_to_check, extra_name)
+# package_to_check is None if no optional dependency is required
+_LAZY_IMPORTS_DATA: dict[str, tuple[str, str | None, str | None]] = {
+    # Desktop handlers (require pyautogui/PIL)
+    "AsyncPyautoguiActionHandler": (
+        "oagi.handler.async_pyautogui_action_handler",
+        "pyautogui",
+        "desktop",
+    ),
+    "AsyncScreenshotMaker": ("oagi.handler.async_screenshot_maker", "PIL", "desktop"),
+    "PILImage": ("oagi.handler.pil_image", "PIL", "desktop"),
+    "PyautoguiActionHandler": (
+        "oagi.handler.pyautogui_action_handler",
+        "pyautogui",
+        "desktop",
+    ),
+    "PyautoguiConfig": (
+        "oagi.handler.pyautogui_action_handler",
+        "pyautogui",
+        "desktop",
+    ),
+    "ScreenshotMaker": ("oagi.handler.screenshot_maker", "PIL", "desktop"),
+    # Agent modules (lazy to avoid circular imports)
+    "AsyncDefaultAgent": ("oagi.agent.default", None, None),
+    "TaskerAgent": ("oagi.agent.tasker", None, None),
+    "AsyncAgentObserver": ("oagi.agent.observer.agent_observer", None, None),
+    # Server modules (require server dependencies)
+    "create_app": ("oagi.server.main", "socketio", "server"),
+    "ServerConfig": ("oagi.server.config", "pydantic_settings", "server"),
+    "sio": ("oagi.server.socketio_server", "socketio", "server"),
+}
+
+if TYPE_CHECKING:
+    from oagi.agent.default import AsyncDefaultAgent
+    from oagi.agent.observer.agent_observer import AsyncAgentObserver
+    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.pil_image import PILImage
+    from oagi.handler.pyautogui_action_handler import (
+        PyautoguiActionHandler,
+        PyautoguiConfig,
+    )
+    from oagi.handler.screenshot_maker import ScreenshotMaker
+    from oagi.server.config import ServerConfig
+    from oagi.server.main import create_app
+    from oagi.server.socketio_server import sio
+
+
+def __getattr__(name: str):
+    """Lazy import for optional dependency modules with helpful error messages."""
+    if name in _LAZY_IMPORTS_DATA:
+        module_path, package, extra = _LAZY_IMPORTS_DATA[name]
+        if package is not None:
+            check_optional_dependency(package, name, extra)
+        module = importlib.import_module(module_path)
+        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(globals().keys()) | set(_LAZY_IMPORTS_DATA.keys()))
+
+
+__all__ = [
+    # Core sync classes
+    "Actor",
+    "AsyncActor",
+    "Task",  # Deprecated: Use Actor instead
+    "ShortTask",  # Deprecated
+    "SyncClient",
+    # Core async classes
+    "AsyncTask",  # Deprecated: Use AsyncActor instead
+    "AsyncShortTask",  # Deprecated
+    "AsyncClient",
+    # Agent classes
+    "AsyncDefaultAgent",
+    "TaskerAgent",
+    "AsyncAgentObserver",
+    # Configuration
+    "ImageConfig",
+    # Response models
+    "LLMResponse",
+    "GenerateResponse",
+    "UploadFileResponse",
+    "ErrorResponse",
+    "ErrorDetail",
+    # Exceptions
+    "OAGIError",
+    "APIError",
+    "AuthenticationError",
+    "ConfigurationError",
+    "NetworkError",
+    "NotFoundError",
+    "RateLimitError",
+    "ServerError",
+    "RequestTimeoutError",
+    "ValidationError",
+    # Lazy imports - Image classes
+    "PILImage",
+    # Lazy imports - Handler classes
+    "PyautoguiActionHandler",
+    "PyautoguiConfig",
+    "ScreenshotMaker",
+    # Lazy imports - Async handler classes
+    "AsyncPyautoguiActionHandler",
+    "AsyncScreenshotMaker",
+    # Lazy imports - Server modules (optional)
+    "create_app",
+    "ServerConfig",
+    "sio",
+]

{oagi_core-0.9.2 → oagi_core-0.10.1}/src/oagi/agent/__init__.py

@@ -9,6 +9,7 @@
 # Import factories to trigger registration
 from . import factories  # noqa: F401
 from .default import AsyncDefaultAgent
+from .observer import AsyncAgentObserver
 from .protocol import Agent, AsyncAgent
 from .registry import (
     async_agent_register,
@@ -21,6 +22,7 @@ from .tasker import TaskeeAgent, TaskerAgent
 __all__ = [
     "Agent",
     "AsyncAgent",
+    "AsyncAgentObserver",
     "AsyncDefaultAgent",
     "TaskerAgent",
     "TaskeeAgent",