oagi-core 0.10.3__tar.gz → 0.11.0__tar.gz

{oagi_core-0.10.3 → oagi_core-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.10.3
+Version: 0.11.0
 Summary: Official API of OpenAGI Foundation
 Project-URL: Homepage, https://github.com/agiopen-org/oagi
 Author-email: OpenAGI Foundation <contact@agiopen.org>
@@ -116,6 +116,39 @@ config = PyautoguiConfig(
 action_handler = AsyncPyautoguiActionHandler(config=config)
 ```
 
+### Command Line Interface
+
+Run agents directly from the terminal:
+
+```bash
+# Run with actor model
+oagi agent run "Go to nasdaq.com, search for AAPL. Under More, go to Insider Activity" --model lux-actor-1
+
+# Run with thinker mode (uses lux-thinker-1 model with more steps)
+oagi agent run "Look up the store hours for the nearest Apple Store to zip code 23456 using the Apple Store Locator" --model lux-thinker-1
+
+# Run pre-configured tasker workflows (no instruction needed)
+oagi agent run --mode tasker:software_qa
+
+# List all available modes
+oagi agent modes
+
+# Check macOS permissions (screen recording & accessibility)
+oagi agent permission
+
+# Export execution history
+oagi agent run "Complete the form" --export html --export-file report.html
+```
+
+CLI options:
+- `--mode`: Agent mode (default: actor). Use `oagi agent modes` to list available modes
+- `--model`: Override the model (default: determined by mode)
+- `--max-steps`: Maximum steps (default: determined by mode)
+- `--temperature`: Sampling temperature (default: determined by mode)
+- `--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
+
 ### Image Processing
 
 Process and optimize images before sending to API:

{oagi_core-0.10.3 → oagi_core-0.11.0}/README.md

@@ -73,6 +73,39 @@ config = PyautoguiConfig(
 action_handler = AsyncPyautoguiActionHandler(config=config)
 ```
 
+### Command Line Interface
+
+Run agents directly from the terminal:
+
+```bash
+# Run with actor model
+oagi agent run "Go to nasdaq.com, search for AAPL. Under More, go to Insider Activity" --model lux-actor-1
+
+# Run with thinker mode (uses lux-thinker-1 model with more steps)
+oagi agent run "Look up the store hours for the nearest Apple Store to zip code 23456 using the Apple Store Locator" --model lux-thinker-1
+
+# Run pre-configured tasker workflows (no instruction needed)
+oagi agent run --mode tasker:software_qa
+
+# List all available modes
+oagi agent modes
+
+# Check macOS permissions (screen recording & accessibility)
+oagi agent permission
+
+# Export execution history
+oagi agent run "Complete the form" --export html --export-file report.html
+```
+
+CLI options:
+- `--mode`: Agent mode (default: actor). Use `oagi agent modes` to list available modes
+- `--model`: Override the model (default: determined by mode)
+- `--max-steps`: Maximum steps (default: determined by mode)
+- `--temperature`: Sampling temperature (default: determined by mode)
+- `--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
+
 ### Image Processing
 
 Process and optimize images before sending to API:

{oagi_core-0.10.3 → oagi_core-0.11.0}/metapackage/pyproject.toml

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

{oagi_core-0.10.3 → oagi_core-0.11.0}/metapackage/uv.lock

@@ -397,27 +397,27 @@ sdist = { url = "https://files.pythonhosted.org/packages/28/fa/b2ba8229b9381e8f6
 
 [[package]]
 name = "oagi"
-version = "0.10.3"
+version = "0.11.0"
 source = { editable = "." }
 dependencies = [
     { name = "oagi-core", extra = ["desktop", "server"] },
 ]
 
 [package.metadata]
-requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.10.2" }]
+requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.10.3" }]
 
 [[package]]
 name = "oagi-core"
-version = "0.10.2"
+version = "0.10.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "pydantic" },
     { name = "rich" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/07/2f/11b7e37049b2faa1e1147a75624c024a93c32287f243c213ca96fc096452/oagi_core-0.10.2.tar.gz", hash = "sha256:2d7fb47031cdc2155ea5ea9c06b4b58c0d70091de95a36fa4dedf5d710a09862", size = 267130, upload-time = "2025-11-26T13:50:36.977Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/60/97/c54ecd43969132f902086d4f7fa7eb8d1f5e5087774c81df463a27b3017f/oagi_core-0.10.3.tar.gz", hash = "sha256:46417fde3b20427338d7e2798246960fd4bc6515e93f95bd32b8236337d6cfcd", size = 268408, upload-time = "2025-11-30T11:34:46.494Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d0/c8/a1d95327afe6237eaf474d74ba66461e51baaf5948d458cb12be62dbf8a8/oagi_core-0.10.2-py3-none-any.whl", hash = "sha256:3b9dd3ade24a1c605d671ed7f35efcd00f729be603a63173c7f92f8177d56750", size = 87220, upload-time = "2025-11-26T13:50:35.872Z" },
+    { url = "https://files.pythonhosted.org/packages/81/22/47271b7d2ac5b7bcaa9d58819b00dfa8e3c0aa57ea3db6e2f6fd681fd0ce/oagi_core-0.10.3-py3-none-any.whl", hash = "sha256:fc91a7bb29ffdcf490bb7edc2574826229ba86726ec6acd505379bdf09645721", size = 88927, upload-time = "2025-11-30T11:34:45.531Z" },
 ]
 
 [package.optional-dependencies]

{oagi_core-0.10.3 → oagi_core-0.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oagi-core"
-version = "0.10.3"
+version = "0.11.0"
 description = "Official API of OpenAGI Foundation"
 readme = "README.md"
 license = { file = "LICENSE" }

{oagi_core-0.10.3 → oagi_core-0.11.0}/src/oagi/agent/default.py

@@ -16,6 +16,7 @@ from ..constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
+from ..handler import reset_handler
 from ..types import (
     ActionEvent,
     AsyncActionHandler,
@@ -68,6 +69,9 @@ class AsyncDefaultAgent:
             logger.info(f"Starting async task execution: {instruction}")
             await self.actor.init_task(instruction, max_steps=self.max_steps)
 
+            # Reset handler state at automation start
+            reset_handler(action_handler)
+
             for i in range(self.max_steps):
                 step_num = i + 1
                 logger.debug(f"Executing step {step_num}/{self.max_steps}")

oagi_core-0.11.0/src/oagi/agent/factories.py

@@ -0,0 +1,162 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+from oagi.agent.tasker import TaskerAgent
+from oagi.constants import (
+    DEFAULT_MAX_STEPS,
+    DEFAULT_MAX_STEPS_TASKER,
+    DEFAULT_MAX_STEPS_THINKER,
+    DEFAULT_REFLECTION_INTERVAL_TASKER,
+    DEFAULT_STEP_DELAY,
+    DEFAULT_TEMPERATURE_LOW,
+    MODEL_ACTOR,
+    MODEL_THINKER,
+)
+from oagi.types import AsyncStepObserver
+
+from .default import AsyncDefaultAgent
+from .protocol import AsyncAgent
+from .registry import async_agent_register
+
+
+@async_agent_register(mode="actor")
+def create_default_agent(
+    api_key: str | None = None,
+    base_url: str | None = None,
+    model: str = MODEL_ACTOR,
+    max_steps: int = DEFAULT_MAX_STEPS,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
+    step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
+) -> AsyncAgent:
+    return AsyncDefaultAgent(
+        api_key=api_key,
+        base_url=base_url,
+        model=model,
+        max_steps=max_steps,
+        temperature=temperature,
+        step_observer=step_observer,
+        step_delay=step_delay,
+    )
+
+
+@async_agent_register(mode="thinker")
+def create_thinker_agent(
+    api_key: str | None = None,
+    base_url: str | None = None,
+    model: str = MODEL_THINKER,
+    max_steps: int = DEFAULT_MAX_STEPS_THINKER,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
+    step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
+) -> AsyncAgent:
+    return AsyncDefaultAgent(
+        api_key=api_key,
+        base_url=base_url,
+        model=model,
+        max_steps=max_steps,
+        temperature=temperature,
+        step_observer=step_observer,
+        step_delay=step_delay,
+    )
+
+
+@async_agent_register(mode="tasker:cvs_appointment")
+def create_cvs_appointment_agent(
+    api_key: str | None = None,
+    base_url: str | None = None,
+    model: str = MODEL_ACTOR,
+    max_steps: int = DEFAULT_MAX_STEPS_TASKER,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
+    reflection_interval: int = DEFAULT_REFLECTION_INTERVAL_TASKER,
+    step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
+    # CVS-specific parameters
+    first_name: str = "First",
+    last_name: str = "Last",
+    email: str = "user@example.com",
+    birthday: str = "01-01-1990",  # MM-DD-YYYY
+    zip_code: str = "00000",
+) -> AsyncAgent:
+    tasker = TaskerAgent(
+        api_key=api_key,
+        base_url=base_url,
+        model=model,
+        max_steps=max_steps,
+        temperature=temperature,
+        reflection_interval=reflection_interval,
+        step_observer=step_observer,
+        step_delay=step_delay,
+    )
+
+    month, day, year = birthday.split("-")
+    instruction = (
+        f"Schedule an appointment at CVS for {first_name} {last_name} "
+        f"with email {email} and birthday {birthday}"
+    )
+    todos = [
+        "Open a new tab, go to www.cvs.com, type 'flu shot' in the search bar and press enter, "
+        "wait for the page to load, then click on the button of Schedule vaccinations on the "
+        "top of the page",
+        f"Enter the first name '{first_name}', last name '{last_name}', and email '{email}' "
+        "in the form. Do not use any suggested autofills. Make sure the mobile phone number "
+        "is empty.",
+        f"Slightly scroll down to see the date of birth, enter Month '{month}', Day '{day}', "
+        f"and Year '{year}' in the form",
+        "Click on 'Continue as guest' button, wait for the page to load with wait, "
+        "click on 'Add vaccines' button, select 'Flu' and click on 'Add vaccines'",
+        f"Click on 'next' to enter the page with recommendation vaccines, then click on "
+        f"'next' again, until on the page of entering zip code, enter '{zip_code}', select "
+        "the first option from the dropdown menu, and click on 'Search'",
+    ]
+
+    tasker.set_task(instruction, todos)
+    return tasker
+
+
+@async_agent_register(mode="tasker:software_qa")
+def create_software_qa_agent(
+    api_key: str | None = None,
+    base_url: str | None = None,
+    model: str = MODEL_ACTOR,
+    max_steps: int = DEFAULT_MAX_STEPS_TASKER,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
+    reflection_interval: int = DEFAULT_REFLECTION_INTERVAL_TASKER,
+    step_observer: AsyncStepObserver | None = None,
+    step_delay: float = DEFAULT_STEP_DELAY,
+) -> AsyncAgent:
+    tasker = TaskerAgent(
+        api_key=api_key,
+        base_url=base_url,
+        model=model,
+        max_steps=max_steps,
+        temperature=temperature,
+        reflection_interval=reflection_interval,
+        step_observer=step_observer,
+        step_delay=step_delay,
+    )
+
+    instruction = "QA: click through every sidebar button in the Nuclear Player UI"
+    todos = [
+        "Click on 'Dashboard' in the left sidebar",
+        "Click on 'Downloads' in the left sidebar",
+        "Click on 'Lyrics' in the left sidebar",
+        "Click on 'Plugins' in the left sidebar",
+        "Click on 'Search Results' in the left sidebar",
+        "Click on 'Settings' in the left sidebar",
+        "Click on 'Equalizer' in the left sidebar",
+        "Click on 'Visualizer' in the left sidebar",
+        "Click on 'Listening History' in the left sidebar",
+        "Click on 'Favorite Albums' in the left sidebar",
+        "Click on 'Favorite Tracks' in the left sidebar",
+        "Click on 'Favorite Artists' in the left sidebar",
+        "Click on 'Local Library' in the left sidebar",
+        "Click on 'Playlists' in the left sidebar",
+    ]
+
+    tasker.set_task(instruction, todos)
+    return tasker

{oagi_core-0.10.3 → oagi_core-0.11.0}/src/oagi/agent/tasker/planner.py

@@ -11,7 +11,7 @@ from typing import Any
 
 from ...client import AsyncClient
 from ...constants import DEFAULT_REFLECTION_INTERVAL
-from ...types import URL, Image
+from ...types import URL, Image, extract_uuid_from_url
 from .memory import PlannerMemory
 from .models import Action, PlannerOutput, ReflectionOutput
 
@@ -138,11 +138,16 @@ class Planner:
         # Ensure we have a client
         client = self._ensure_client()
 
-        # Upload screenshot if provided
+        # Get screenshot UUID - either extract from URL or upload
         screenshot_uuid = None
         if screenshot:
-            upload_response = await client.put_s3_presigned_url(screenshot)
-            screenshot_uuid = upload_response.uuid
+            # Check if screenshot is already a URL (already uploaded to S3)
+            if isinstance(screenshot, str):
+                screenshot_uuid = extract_uuid_from_url(screenshot)
+            # If not a URL or UUID extraction failed, upload the image
+            if not screenshot_uuid:
+                upload_response = await client.put_s3_presigned_url(screenshot)
+                screenshot_uuid = upload_response.uuid
 
         # Extract memory data if provided
         (
@@ -195,11 +200,16 @@ class Planner:
         # Ensure we have a client
         client = self._ensure_client()
 
-        # Upload screenshot if provided
+        # Get screenshot UUID - either extract from URL or upload
         result_screenshot_uuid = None
         if screenshot:
-            upload_response = await client.put_s3_presigned_url(screenshot)
-            result_screenshot_uuid = upload_response.uuid
+            # Check if screenshot is already a URL (already uploaded to S3)
+            if isinstance(screenshot, str):
+                result_screenshot_uuid = extract_uuid_from_url(screenshot)
+            # If not a URL or UUID extraction failed, upload the image
+            if not result_screenshot_uuid:
+                upload_response = await client.put_s3_presigned_url(screenshot)
+                result_screenshot_uuid = upload_response.uuid
 
         # Extract memory data if provided
         (

{oagi_core-0.10.3 → oagi_core-0.11.0}/src/oagi/agent/tasker/taskee_agent.py

@@ -19,6 +19,7 @@ from oagi.constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
+from oagi.handler import reset_handler
 from oagi.types import (
     URL,
     ActionEvent,
@@ -28,6 +29,7 @@ from oagi.types import (
     Image,
     PlanEvent,
     StepEvent,
+    extract_uuid_from_url,
 )
 
 from ..protocol import AsyncAgent
@@ -121,6 +123,9 @@ class TaskeeAgent(AsyncAgent):
         Returns:
             True if successful, False otherwise
         """
+        # Reset handler state at todo execution start
+        reset_handler(action_handler)
+
         self.current_todo = instruction
         self.actions = []
         self.total_actions = 0
@@ -256,11 +261,21 @@ class TaskeeAgent(AsyncAgent):
             # Capture screenshot
             screenshot = await image_provider()
 
-            # Upload screenshot first to get UUID (avoids re-upload in actor.step)
+            # Get screenshot UUID - either extract from URL or upload
             try:
-                upload_response = await client.put_s3_presigned_url(screenshot)
-                screenshot_uuid = upload_response.uuid
-                screenshot_url = upload_response.download_url
+                screenshot_uuid = None
+                screenshot_url = None
+
+                # Check if screenshot is already a URL (from SocketIOImageProvider)
+                if isinstance(screenshot, str):
+                    screenshot_uuid = extract_uuid_from_url(screenshot)
+                    screenshot_url = screenshot
+
+                # If not a URL or UUID extraction failed, upload the image
+                if not screenshot_uuid:
+                    upload_response = await client.put_s3_presigned_url(screenshot)
+                    screenshot_uuid = upload_response.uuid
+                    screenshot_url = upload_response.download_url
             except Exception as e:
                 logger.error(f"Error uploading screenshot: {e}")
                 self._record_action(

{oagi_core-0.10.3 → oagi_core-0.11.0}/src/oagi/agent/tasker/tasker_agent.py

@@ -16,6 +16,7 @@ from oagi.constants import (
     DEFAULT_TEMPERATURE,
     MODEL_ACTOR,
 )
+from oagi.handler import reset_handler
 from oagi.types import AsyncActionHandler, AsyncImageProvider, AsyncObserver, SplitEvent
 
 from ..protocol import AsyncAgent
@@ -112,6 +113,9 @@ class TaskerAgent(AsyncAgent):
         Returns:
             True if all todos completed successfully, False otherwise
         """
+        # Reset handler state at automation start
+        reset_handler(action_handler)
+
         overall_success = True
 
         # Execute todos until none remain

{oagi_core-0.10.3 → oagi_core-0.11.0}/src/oagi/cli/agent.py

@@ -17,12 +17,9 @@ from oagi.agent.observer import AsyncAgentObserver
 from oagi.constants import (
     API_KEY_HELP_URL,
     DEFAULT_BASE_URL,
-    DEFAULT_MAX_STEPS,
     DEFAULT_MAX_STEPS_THINKER,
     DEFAULT_STEP_DELAY,
-    DEFAULT_TEMPERATURE,
     MODE_ACTOR,
-    MODEL_ACTOR,
     MODEL_THINKER,
 )
 from oagi.exceptions import check_optional_dependency
@@ -40,22 +37,30 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
         "run", help="Run an agent with the given instruction"
     )
     run_parser.add_argument(
-        "instruction", type=str, help="Task instruction for the agent to execute"
+        "instruction",
+        type=str,
+        nargs="?",
+        default="",
+        help="Task instruction for the agent to execute (optional for pre-configured modes)",
     )
     run_parser.add_argument(
-        "--model", type=str, help=f"Model to use (default: {MODEL_ACTOR})"
+        "--model", type=str, help="Model to use (default: determined by mode)"
     )
     run_parser.add_argument(
-        "--max-steps", type=int, help="Maximum number of steps (default: 20)"
+        "--max-steps",
+        type=int,
+        help="Maximum number of steps (default: determined by mode)",
     )
     run_parser.add_argument(
-        "--temperature", type=float, help="Sampling temperature (default: 0.5)"
+        "--temperature",
+        type=float,
+        help="Sampling temperature (default: determined by mode)",
     )
     run_parser.add_argument(
         "--mode",
         type=str,
         default=MODE_ACTOR,
-        help=f"Agent mode to use (default: {MODE_ACTOR}). Available modes: actor, planner",
+        help=f"Agent mode to use (default: {MODE_ACTOR}). Use 'oagi agent modes' to list available modes",
     )
     run_parser.add_argument(
         "--oagi-api-key", type=str, help="OAGI API key (default: OAGI_API_KEY env var)"
@@ -82,6 +87,9 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
         help=f"Delay in seconds after each step before next screenshot (default: {DEFAULT_STEP_DELAY})",
     )
 
+    # agent modes command
+    agent_subparsers.add_parser("modes", help="List available agent modes")
+
     # agent permission command
     agent_subparsers.add_parser(
         "permission",
@@ -92,10 +100,22 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
 def handle_agent_command(args: argparse.Namespace) -> None:
     if args.agent_command == "run":
         run_agent(args)
+    elif args.agent_command == "modes":
+        list_modes()
     elif args.agent_command == "permission":
         check_permissions()
 
 
+def list_modes() -> None:
+    """List all available agent modes."""
+    from oagi.agent import list_agent_modes  # noqa: PLC0415
+
+    modes = list_agent_modes()
+    print("Available agent modes:")
+    for mode in modes:
+        print(f"  - {mode}")
+
+
 def check_permissions() -> None:
     """Check and request macOS permissions for screen recording and accessibility.
 
@@ -207,14 +227,6 @@ def run_agent(args: argparse.Namespace) -> None:
         sys.exit(1)
 
     base_url = args.oagi_base_url or os.getenv("OAGI_BASE_URL", DEFAULT_BASE_URL)
-    model = args.model or MODEL_ACTOR
-    default_max_steps = (
-        DEFAULT_MAX_STEPS_THINKER if model == MODEL_THINKER else DEFAULT_MAX_STEPS
-    )
-    max_steps = args.max_steps or default_max_steps
-    temperature = (
-        args.temperature if args.temperature is not None else DEFAULT_TEMPERATURE
-    )
     mode = args.mode or MODE_ACTOR
     step_delay = args.step_delay if args.step_delay is not None else DEFAULT_STEP_DELAY
     export_format = args.export
@@ -233,26 +245,38 @@ def run_agent(args: argparse.Namespace) -> None:
 
     observer = CombinedObserver()
 
-    # Create agent with observer
-    agent = create_agent(
-        mode=mode,
-        api_key=api_key,
-        base_url=base_url,
-        model=model,
-        max_steps=max_steps,
-        temperature=temperature,
-        step_observer=observer,
-        step_delay=step_delay,
-    )
+    # Build agent kwargs - only pass explicitly provided values, let factory use defaults
+    agent_kwargs = {
+        "mode": mode,
+        "api_key": api_key,
+        "base_url": base_url,
+        "step_observer": observer,
+        "step_delay": step_delay,
+    }
+    if args.model:
+        agent_kwargs["model"] = args.model
+        # If thinker model specified without max_steps, use thinker's default
+        if args.model == MODEL_THINKER and not args.max_steps:
+            agent_kwargs["max_steps"] = DEFAULT_MAX_STEPS_THINKER
+    if args.max_steps:
+        agent_kwargs["max_steps"] = args.max_steps
+    if args.temperature is not None:
+        agent_kwargs["temperature"] = args.temperature
+
+    # Create agent
+    agent = create_agent(**agent_kwargs)
 
     # Create handlers
     action_handler = AsyncPyautoguiActionHandler()
     image_provider = AsyncScreenshotMaker()
 
-    print(f"Starting agent with instruction: {args.instruction}")
+    if args.instruction:
+        print(f"Starting agent with instruction: {args.instruction}")
+    else:
+        print(f"Starting agent with mode: {mode} (using pre-configured instruction)")
     print(
-        f"Mode: {mode}, Model: {model}, Max steps: {max_steps}, "
-        f"Temperature: {temperature}, Step delay: {step_delay}s"
+        f"Mode: {mode}, Model: {agent.model}, Max steps: {agent.max_steps}, "
+        f"Temperature: {agent.temperature}, Step delay: {step_delay}s"
     )
     print("-" * 60)
 

{oagi_core-0.10.3 → oagi_core-0.11.0}/src/oagi/handler/__init__.py

@@ -14,6 +14,21 @@ from oagi.handler.pyautogui_action_handler import (
 )
 from oagi.handler.screenshot_maker import ScreenshotMaker
 
+
+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()
+
+
 __all__ = [
     "PILImage",
     "PyautoguiActionHandler",
@@ -21,4 +36,5 @@ __all__ = [
     "AsyncPyautoguiActionHandler",
     "ScreenshotMaker",
     "AsyncScreenshotMaker",
+    "reset_handler",
 ]