oagi-core 0.10.2__py3-none-any.whl → 0.10.3__py3-none-any.whl

oagi/agent/default.py

@@ -10,6 +10,12 @@ import asyncio
 import logging
 
 from .. import AsyncActor
+from ..constants import (
+    DEFAULT_MAX_STEPS,
+    DEFAULT_STEP_DELAY,
+    DEFAULT_TEMPERATURE,
+    MODEL_ACTOR,
+)
 from ..types import (
     ActionEvent,
     AsyncActionHandler,
@@ -36,11 +42,11 @@ class AsyncDefaultAgent:
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
-        max_steps: int = 20,
-        temperature: float | None = 0.5,
+        model: str = MODEL_ACTOR,
+        max_steps: int = DEFAULT_MAX_STEPS,
+        temperature: float | None = DEFAULT_TEMPERATURE,
         step_observer: AsyncObserver | None = None,
-        step_delay: float = 0.3,
+        step_delay: float = DEFAULT_STEP_DELAY,
     ):
         self.api_key = api_key
         self.base_url = base_url

oagi/agent/factories.py

@@ -6,6 +6,16 @@
 #  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
@@ -17,11 +27,11 @@ from .registry import async_agent_register
 def create_default_agent(
     api_key: str | None = None,
     base_url: str | None = None,
-    model: str = "lux-actor-1",
-    max_steps: int = 20,
-    temperature: float = 0.1,
+    model: str = MODEL_ACTOR,
+    max_steps: int = DEFAULT_MAX_STEPS,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
     step_observer: AsyncStepObserver | None = None,
-    step_delay: float = 0.3,
+    step_delay: float = DEFAULT_STEP_DELAY,
 ) -> AsyncAgent:
     return AsyncDefaultAgent(
         api_key=api_key,
@@ -38,11 +48,11 @@ def create_default_agent(
 def create_thinker_agent(
     api_key: str | None = None,
     base_url: str | None = None,
-    model: str = "lux-thinker-1",
-    max_steps: int = 100,
-    temperature: float = 0.1,
+    model: str = MODEL_THINKER,
+    max_steps: int = DEFAULT_MAX_STEPS_THINKER,
+    temperature: float = DEFAULT_TEMPERATURE_LOW,
     step_observer: AsyncStepObserver | None = None,
-    step_delay: float = 0.3,
+    step_delay: float = DEFAULT_STEP_DELAY,
 ) -> AsyncAgent:
     return AsyncDefaultAgent(
         api_key=api_key,
@@ -59,12 +69,12 @@ def create_thinker_agent(
 def create_planner_agent(
     api_key: str | None = None,
     base_url: str | None = None,
-    model: str = "lux-actor-1",
-    max_steps: int = 30,
-    temperature: float = 0.1,
-    reflection_interval: int = 20,
+    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 = 0.3,
+    step_delay: float = DEFAULT_STEP_DELAY,
 ) -> AsyncAgent:
     tasker = TaskerAgent(
         api_key=api_key,

oagi/agent/tasker/planner.py

@@ -10,6 +10,7 @@ import json
 from typing import Any
 
 from ...client import AsyncClient
+from ...constants import DEFAULT_REFLECTION_INTERVAL
 from ...types import URL, Image
 from .memory import PlannerMemory
 from .models import Action, PlannerOutput, ReflectionOutput
@@ -175,7 +176,7 @@ class Planner:
         memory: PlannerMemory | None = None,
         todo_index: int | None = None,
         current_instruction: str | None = None,
-        reflection_interval: int = 4,
+        reflection_interval: int = DEFAULT_REFLECTION_INTERVAL,
     ) -> ReflectionOutput:
         """Reflect on recent actions and progress.
 

oagi/agent/tasker/taskee_agent.py

@@ -12,6 +12,13 @@ from datetime import datetime
 from typing import Any
 
 from oagi import AsyncActor
+from oagi.constants import (
+    DEFAULT_MAX_STEPS,
+    DEFAULT_REFLECTION_INTERVAL,
+    DEFAULT_STEP_DELAY,
+    DEFAULT_TEMPERATURE,
+    MODEL_ACTOR,
+)
 from oagi.types import (
     URL,
     ActionEvent,
@@ -52,15 +59,15 @@ class TaskeeAgent(AsyncAgent):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
-        max_steps: int = 20,
-        reflection_interval: int = 4,
-        temperature: float = 0.5,
+        model: str = MODEL_ACTOR,
+        max_steps: int = DEFAULT_MAX_STEPS,
+        reflection_interval: int = DEFAULT_REFLECTION_INTERVAL,
+        temperature: float = DEFAULT_TEMPERATURE,
         planner: Planner | None = None,
         external_memory: PlannerMemory | None = None,
         todo_index: int | None = None,
         step_observer: AsyncObserver | None = None,
-        step_delay: float = 0.3,
+        step_delay: float = DEFAULT_STEP_DELAY,
     ):
         """Initialize the taskee agent.
 

oagi/agent/tasker/tasker_agent.py

@@ -9,6 +9,13 @@
 import logging
 from typing import Any
 
+from oagi.constants import (
+    DEFAULT_MAX_STEPS_TASKER,
+    DEFAULT_REFLECTION_INTERVAL,
+    DEFAULT_STEP_DELAY,
+    DEFAULT_TEMPERATURE,
+    MODEL_ACTOR,
+)
 from oagi.types import AsyncActionHandler, AsyncImageProvider, AsyncObserver, SplitEvent
 
 from ..protocol import AsyncAgent
@@ -34,13 +41,13 @@ class TaskerAgent(AsyncAgent):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
-        max_steps: int = 60,
-        temperature: float = 0.5,
-        reflection_interval: int = 4,
+        model: str = MODEL_ACTOR,
+        max_steps: int = DEFAULT_MAX_STEPS_TASKER,
+        temperature: float = DEFAULT_TEMPERATURE,
+        reflection_interval: int = DEFAULT_REFLECTION_INTERVAL,
         planner: Planner | None = None,
         step_observer: AsyncObserver | None = None,
-        step_delay: float = 0.3,
+        step_delay: float = DEFAULT_STEP_DELAY,
     ):
         """Initialize the tasker agent.
 

oagi/cli/agent.py

@@ -14,6 +14,17 @@ import time
 import traceback
 
 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
 
 from .display import display_step_table
@@ -32,7 +43,7 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
         "instruction", type=str, help="Task instruction for the agent to execute"
     )
     run_parser.add_argument(
-        "--model", type=str, help="Model to use (default: lux-actor-1)"
+        "--model", type=str, help=f"Model to use (default: {MODEL_ACTOR})"
     )
     run_parser.add_argument(
         "--max-steps", type=int, help="Maximum number of steps (default: 20)"
@@ -43,8 +54,8 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
     run_parser.add_argument(
         "--mode",
         type=str,
-        default="actor",
-        help="Agent mode to use (default: actor). Available modes: actor, planner",
+        default=MODE_ACTOR,
+        help=f"Agent mode to use (default: {MODE_ACTOR}). Available modes: actor, planner",
     )
     run_parser.add_argument(
         "--oagi-api-key", type=str, help="OAGI API key (default: OAGI_API_KEY env var)"
@@ -52,7 +63,7 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
     run_parser.add_argument(
         "--oagi-base-url",
         type=str,
-        help="OAGI base URL (default: https://api.agiopen.org, or OAGI_BASE_URL env var)",
+        help=f"OAGI base URL (default: {DEFAULT_BASE_URL}, or OAGI_BASE_URL env var)",
     )
     run_parser.add_argument(
         "--export",
@@ -68,7 +79,7 @@ def add_agent_parser(subparsers: argparse._SubParsersAction) -> None:
     run_parser.add_argument(
         "--step-delay",
         type=float,
-        help="Delay in seconds after each step before next screenshot (default: 0.3)",
+        help=f"Delay in seconds after each step before next screenshot (default: {DEFAULT_STEP_DELAY})",
     )
 
     # agent permission command
@@ -189,19 +200,23 @@ def run_agent(args: argparse.Namespace) -> None:
     if not api_key:
         print(
             "Error: OAGI API key not provided.\n"
-            "Set OAGI_API_KEY environment variable or use --oagi-api-key flag.",
+            "Set OAGI_API_KEY environment variable or use --oagi-api-key flag.\n"
+            f"Get your API key at {API_KEY_HELP_URL}",
             file=sys.stderr,
         )
         sys.exit(1)
 
-    base_url = args.oagi_base_url or os.getenv(
-        "OAGI_BASE_URL", "https://api.agiopen.org"
+    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
     )
-    model = args.model or "lux-actor-1"
-    max_steps = args.max_steps or 20
-    temperature = args.temperature if args.temperature is not None else 0.5
-    mode = args.mode or "actor"
-    step_delay = args.step_delay if args.step_delay is not None else 0.3
+    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
     export_file = args.export_file
 

oagi/cli/display.py

@@ -29,7 +29,8 @@ def display_step_table(
         actions_display = []
         for action in step.actions[:3]:
             arg = action.argument[:20] if action.argument else ""
-            actions_display.append(f"{action.type.value}({arg})")
+            count_str = f" x{action.count}" if action.count and action.count > 1 else ""
+            actions_display.append(f"{action.type.value}({arg}){count_str}")
 
         actions_str = ", ".join(actions_display)
         if len(step.actions) > 3:

oagi/cli/server.py

@@ -25,7 +25,7 @@ def add_server_parser(subparsers: argparse._SubParsersAction) -> None:
     start_parser.add_argument(
         "--host",
         type=str,
-        help="Server host (default: 0.0.0.0, or OAGI_SERVER_HOST env var)",
+        help="Server host (default: 127.0.0.1, or OAGI_SERVER_HOST env var)",
     )
     start_parser.add_argument(
         "--port",

oagi/cli/utils.py

@@ -11,6 +11,7 @@ import os
 import sys
 from importlib.metadata import version as get_version
 
+from oagi.constants import DEFAULT_BASE_URL, MODEL_ACTOR
 from oagi.exceptions import check_optional_dependency
 
 
@@ -55,10 +56,10 @@ def display_version() -> None:
 def display_config() -> None:
     config_vars = {
         "OAGI_API_KEY": os.getenv("OAGI_API_KEY", ""),
-        "OAGI_BASE_URL": os.getenv("OAGI_BASE_URL", "https://api.agiopen.org"),
-        "OAGI_DEFAULT_MODEL": os.getenv("OAGI_DEFAULT_MODEL", "lux-actor-1"),
+        "OAGI_BASE_URL": os.getenv("OAGI_BASE_URL", DEFAULT_BASE_URL),
+        "OAGI_DEFAULT_MODEL": os.getenv("OAGI_DEFAULT_MODEL", MODEL_ACTOR),
         "OAGI_LOG_LEVEL": os.getenv("OAGI_LOG_LEVEL", "INFO"),
-        "OAGI_SERVER_HOST": os.getenv("OAGI_SERVER_HOST", "0.0.0.0"),
+        "OAGI_SERVER_HOST": os.getenv("OAGI_SERVER_HOST", "127.0.0.1"),
         "OAGI_SERVER_PORT": os.getenv("OAGI_SERVER_PORT", "8000"),
         "OAGI_MAX_STEPS": os.getenv("OAGI_MAX_STEPS", "30"),
     }

oagi/client/async_.py

@@ -10,6 +10,13 @@ from functools import wraps
 
 import httpx
 
+from ..constants import (
+    API_HEALTH_ENDPOINT,
+    API_V1_FILE_UPLOAD_ENDPOINT,
+    API_V1_GENERATE_ENDPOINT,
+    API_V2_MESSAGE_ENDPOINT,
+    HTTP_CLIENT_TIMEOUT,
+)
 from ..logging import get_logger
 from ..types import Image
 from ..types.models import GenerateResponse, LLMResponse, UploadFileResponse
@@ -41,7 +48,7 @@ class AsyncClient(BaseClient[httpx.AsyncClient]):
     def __init__(self, base_url: str | None = None, api_key: str | None = None):
         super().__init__(base_url, api_key)
         self.client = httpx.AsyncClient(base_url=self.base_url)
-        self.upload_client = httpx.AsyncClient(timeout=60)  # client for uploading image
+        self.upload_client = httpx.AsyncClient(timeout=HTTP_CLIENT_TIMEOUT)
         logger.info(f"AsyncClient initialized with base_url: {self.base_url}")
 
     async def __aenter__(self):
@@ -121,7 +128,10 @@ class AsyncClient(BaseClient[httpx.AsyncClient]):
         # Make request
         try:
             response = await self.client.post(
-                "/v2/message", json=payload, headers=headers, timeout=self.timeout
+                API_V2_MESSAGE_ENDPOINT,
+                json=payload,
+                headers=headers,
+                timeout=self.timeout,
             )
             return self._process_response(response)
         except (httpx.TimeoutException, httpx.NetworkError) as e:
@@ -136,7 +146,7 @@ class AsyncClient(BaseClient[httpx.AsyncClient]):
         """
         logger.debug("Making async health check request")
         try:
-            response = await self.client.get("/health")
+            response = await self.client.get(API_HEALTH_ENDPOINT)
             response.raise_for_status()
             result = response.json()
             logger.debug("Async health check successful")
@@ -158,12 +168,12 @@ class AsyncClient(BaseClient[httpx.AsyncClient]):
         Returns:
             UploadFileResponse: The response from /v1/file/upload with uuid and presigned S3 URL
         """
-        logger.debug("Making async API request to /v1/file/upload")
+        logger.debug(f"Making async API request to {API_V1_FILE_UPLOAD_ENDPOINT}")
 
         try:
             headers = self._build_headers(api_version)
             response = await self.client.get(
-                "/v1/file/upload", headers=headers, timeout=self.timeout
+                API_V1_FILE_UPLOAD_ENDPOINT, headers=headers, timeout=self.timeout
             )
             return self._process_upload_response(response)
         except (httpx.TimeoutException, httpx.NetworkError, httpx.HTTPStatusError) as e:
@@ -283,7 +293,10 @@ class AsyncClient(BaseClient[httpx.AsyncClient]):
         # Make request
         try:
             response = await self.client.post(
-                "/v1/generate", json=payload, headers=headers, timeout=self.timeout
+                API_V1_GENERATE_ENDPOINT,
+                json=payload,
+                headers=headers,
+                timeout=self.timeout,
             )
             return self._process_generate_response(response)
         except (httpx.TimeoutException, httpx.NetworkError) as e:

oagi/client/base.py

@@ -11,6 +11,7 @@ from typing import Any, Generic, TypeVar
 
 import httpx
 
+from ..constants import API_KEY_HELP_URL, DEFAULT_BASE_URL, HTTP_CLIENT_TIMEOUT
 from ..exceptions import (
     APIError,
     AuthenticationError,
@@ -41,20 +42,19 @@ class BaseClient(Generic[HttpClientT]):
 
     def __init__(self, base_url: str | None = None, api_key: str | None = None):
         # Get from environment if not provided
-        self.base_url = (
-            base_url or os.getenv("OAGI_BASE_URL") or "https://api.agiopen.org"
-        )
+        self.base_url = base_url or os.getenv("OAGI_BASE_URL") or DEFAULT_BASE_URL
         self.api_key = api_key or os.getenv("OAGI_API_KEY")
 
         # Validate required configuration
         if not self.api_key:
             raise ConfigurationError(
                 "OAGI API key must be provided either as 'api_key' parameter or "
-                "OAGI_API_KEY environment variable"
+                "OAGI_API_KEY environment variable. "
+                f"Get your API key at {API_KEY_HELP_URL}"
             )
 
         self.base_url = self.base_url.rstrip("/")
-        self.timeout = 60
+        self.timeout = HTTP_CLIENT_TIMEOUT
         self.client: HttpClientT  # Will be set by subclasses
 
         logger.info(f"Client initialized with base_url: {self.base_url}")
@@ -273,22 +273,20 @@ class BaseClient(Generic[HttpClientT]):
             NetworkError: If network error occurs
             APIError: If API returns error or invalid response
         """
+        response_data = self._parse_response_json(response)
+
+        # Check for error status codes first (follows _process_response pattern)
+        if response.status_code != 200:
+            self._handle_response_error(response, response_data)
+
         try:
-            response_data = response.json()
             upload_file_response = UploadFileResponse(**response_data)
             logger.debug("Calling /v1/file/upload successful")
             return upload_file_response
-        except ValueError:
-            logger.error(f"Non-JSON API response: {response.status_code}")
-            raise APIError(
-                f"Invalid response format (status {response.status_code})",
-                status_code=response.status_code,
-                response=response,
-            )
-        except KeyError as e:
-            logger.error(f"Invalid response: {response.status_code}")
+        except Exception as e:
+            logger.error(f"Invalid upload response: {response.status_code}")
             raise APIError(
-                f"Invalid presigned S3 URL response: missing field {e}",
+                f"Invalid presigned S3 URL response: {e}",
                 status_code=response.status_code,
                 response=response,
             )

oagi/client/sync.py

@@ -11,6 +11,13 @@ from functools import wraps
 import httpx
 from httpx import Response
 
+from ..constants import (
+    API_HEALTH_ENDPOINT,
+    API_V1_FILE_UPLOAD_ENDPOINT,
+    API_V1_GENERATE_ENDPOINT,
+    API_V2_MESSAGE_ENDPOINT,
+    HTTP_CLIENT_TIMEOUT,
+)
 from ..logging import get_logger
 from ..types import Image
 from ..types.models import GenerateResponse, LLMResponse, UploadFileResponse
@@ -46,7 +53,7 @@ class SyncClient(BaseClient[httpx.Client]):
     def __init__(self, base_url: str | None = None, api_key: str | None = None):
         super().__init__(base_url, api_key)
         self.client = httpx.Client(base_url=self.base_url)
-        self.upload_client = httpx.Client(timeout=60)  # client for uploading image
+        self.upload_client = httpx.Client(timeout=HTTP_CLIENT_TIMEOUT)
         logger.info(f"SyncClient initialized with base_url: {self.base_url}")
 
     def __enter__(self):
@@ -124,7 +131,10 @@ class SyncClient(BaseClient[httpx.Client]):
         # Make request
         try:
             response = self.client.post(
-                "/v2/message", json=payload, headers=headers, timeout=self.timeout
+                API_V2_MESSAGE_ENDPOINT,
+                json=payload,
+                headers=headers,
+                timeout=self.timeout,
             )
             return self._process_response(response)
         except (httpx.TimeoutException, httpx.NetworkError) as e:
@@ -139,7 +149,7 @@ class SyncClient(BaseClient[httpx.Client]):
         """
         logger.debug("Making health check request")
         try:
-            response = self.client.get("/health")
+            response = self.client.get(API_HEALTH_ENDPOINT)
             response.raise_for_status()
             result = response.json()
             logger.debug("Health check successful")
@@ -161,12 +171,12 @@ class SyncClient(BaseClient[httpx.Client]):
         Returns:
             UploadFileResponse: The response from /v1/file/upload with uuid and presigned S3 URL
         """
-        logger.debug("Making API request to /v1/file/upload")
+        logger.debug(f"Making API request to {API_V1_FILE_UPLOAD_ENDPOINT}")
 
         try:
             headers = self._build_headers(api_version)
             response = self.client.get(
-                "/v1/file/upload", headers=headers, timeout=self.timeout
+                API_V1_FILE_UPLOAD_ENDPOINT, headers=headers, timeout=self.timeout
             )
             return self._process_upload_response(response)
         except (httpx.TimeoutException, httpx.NetworkError, httpx.HTTPStatusError) as e:
@@ -286,7 +296,10 @@ class SyncClient(BaseClient[httpx.Client]):
         # Make request
         try:
             response = self.client.post(
-                "/v1/generate", json=payload, headers=headers, timeout=self.timeout
+                API_V1_GENERATE_ENDPOINT,
+                json=payload,
+                headers=headers,
+                timeout=self.timeout,
             )
             return self._process_generate_response(response)
         except (httpx.TimeoutException, httpx.NetworkError) as e:

oagi/constants.py

@@ -0,0 +1,43 @@
+# -----------------------------------------------------------------------------
+#  Copyright (c) OpenAGI Foundation
+#  All rights reserved.
+#
+#  This file is part of the official API project.
+#  Licensed under the MIT License.
+# -----------------------------------------------------------------------------
+
+# URLs & API Endpoints
+DEFAULT_BASE_URL = "https://api.agiopen.org"
+API_KEY_HELP_URL = "https://developer.agiopen.org/api-keys"
+API_V2_MESSAGE_ENDPOINT = "/v2/message"
+API_V1_FILE_UPLOAD_ENDPOINT = "/v1/file/upload"
+API_V1_GENERATE_ENDPOINT = "/v1/generate"
+API_HEALTH_ENDPOINT = "/health"
+
+# Model identifiers
+MODEL_ACTOR = "lux-actor-1"
+MODEL_THINKER = "lux-thinker-1"
+
+# Agent modes
+MODE_ACTOR = "actor"
+MODE_THINKER = "thinker"
+MODE_TASKER = "tasker"
+
+# Default max steps per model
+DEFAULT_MAX_STEPS = 20
+DEFAULT_MAX_STEPS_THINKER = 100
+DEFAULT_MAX_STEPS_TASKER = 60
+
+# Reflection intervals
+DEFAULT_REFLECTION_INTERVAL = 4
+DEFAULT_REFLECTION_INTERVAL_TASKER = 20
+
+# Timing & Delays
+DEFAULT_STEP_DELAY = 0.3
+
+# Temperature Defaults
+DEFAULT_TEMPERATURE = 0.5
+DEFAULT_TEMPERATURE_LOW = 0.1
+
+# Timeout Values
+HTTP_CLIENT_TIMEOUT = 60

oagi/handler/pyautogui_action_handler.py

@@ -64,7 +64,8 @@ class PyautoguiConfig(BaseModel):
         default=0.5, description="Duration for drag operations in seconds"
     )
     scroll_amount: int = Field(
-        default=30, description="Amount to scroll (positive for up, negative for down)"
+        default=2 if sys.platform == "darwin" else 100,
+        description="Amount to scroll (positive for up, negative for down)",
     )
     wait_duration: float = Field(
         default=1.0, description="Duration for wait actions in seconds"

oagi/server/config.py

@@ -8,6 +8,7 @@
 
 from pydantic import Field
 
+from ..constants import DEFAULT_MAX_STEPS, MODEL_ACTOR
 from ..exceptions import check_optional_dependency
 
 check_optional_dependency("pydantic_settings", "Server features", "server")
@@ -20,7 +21,7 @@ class ServerConfig(BaseSettings):
     oagi_base_url: str = Field(default="https://api.agiopen.org", alias="OAGI_BASE_URL")
 
     # Server settings
-    server_host: str = Field(default="0.0.0.0", alias="OAGI_SERVER_HOST")
+    server_host: str = Field(default="127.0.0.1", alias="OAGI_SERVER_HOST")
     server_port: int = Field(default=8000, alias="OAGI_SERVER_PORT")
     cors_allowed_origins: str = Field(default="*", alias="OAGI_CORS_ORIGINS")
 
@@ -28,11 +29,13 @@ class ServerConfig(BaseSettings):
     session_timeout_seconds: float = Field(default=10.0)
 
     # Model settings
-    default_model: str = Field(default="lux-actor-1", alias="OAGI_DEFAULT_MODEL")
+    default_model: str = Field(default=MODEL_ACTOR, alias="OAGI_DEFAULT_MODEL")
     default_temperature: float = Field(default=0.5, ge=0.0, le=2.0)
 
     # Agent settings
-    max_steps: int = Field(default=20, alias="OAGI_MAX_STEPS", ge=1, le=100)
+    max_steps: int = Field(
+        default=DEFAULT_MAX_STEPS, alias="OAGI_MAX_STEPS", ge=1, le=200
+    )
 
     # Socket.IO settings
     socketio_path: str = Field(default="/socket.io")

oagi/server/models.py

@@ -10,13 +10,15 @@ from typing import Literal
 
 from pydantic import BaseModel, Field
 
+from ..constants import DEFAULT_TEMPERATURE_LOW, MODE_ACTOR, MODEL_ACTOR
+
 
 # Client-to-server events
 class InitEventData(BaseModel):
     instruction: str = Field(...)
-    mode: str | None = Field(default="actor")
-    model: str | None = Field(default="lux-actor-1")
-    temperature: float | None = Field(default=0.1, ge=0.0, le=2.0)
+    mode: str | None = Field(default=MODE_ACTOR)
+    model: str | None = Field(default=MODEL_ACTOR)
+    temperature: float | None = Field(default=DEFAULT_TEMPERATURE_LOW, ge=0.0, le=2.0)
 
 
 # Server-to-client events

oagi/server/session_store.py

@@ -11,14 +11,16 @@ from datetime import datetime
 from typing import Any
 from uuid import uuid4
 
+from ..constants import MODE_ACTOR, MODEL_ACTOR
+
 
 class Session:
     def __init__(
         self,
         session_id: str,
         instruction: str,
-        mode: str = "actor",
-        model: str = "lux-actor-1",
+        mode: str = MODE_ACTOR,
+        model: str = MODEL_ACTOR,
         temperature: float = 0.0,
     ):
         self.session_id: str = session_id
@@ -53,8 +55,8 @@ class SessionStore:
     def create_session(
         self,
         instruction: str,
-        mode: str = "actor",
-        model: str = "lux-actor-1",
+        mode: str = MODE_ACTOR,
+        model: str = MODEL_ACTOR,
         temperature: float = 0.0,
         session_id: str | None = None,
     ) -> str:

oagi/server/socketio_server.py

@@ -15,6 +15,7 @@ from pydantic import ValidationError
 
 from ..agent import AsyncDefaultAgent, create_agent
 from ..client import AsyncClient
+from ..constants import MODE_ACTOR
 from ..exceptions import check_optional_dependency
 from ..types.models.action import (
     Action,
@@ -80,7 +81,7 @@ class SessionNamespace(socketio.AsyncNamespace):
             session = Session(
                 session_id=session_id,
                 instruction="",
-                mode="actor",  # Default mode
+                mode=MODE_ACTOR,
                 model=self.config.default_model,
                 temperature=self.config.default_temperature,
             )

oagi/task/async_.py

@@ -9,6 +9,7 @@
 import warnings
 
 from ..client import AsyncClient
+from ..constants import DEFAULT_MAX_STEPS, MODEL_ACTOR
 from ..types import URL, Image, Step
 from .base import BaseActor
 
@@ -20,7 +21,7 @@ class AsyncActor(BaseActor):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
+        model: str = MODEL_ACTOR,
         temperature: float | None = None,
     ):
         super().__init__(api_key, base_url, model, temperature)
@@ -31,7 +32,7 @@ class AsyncActor(BaseActor):
     async def init_task(
         self,
         task_desc: str,
-        max_steps: int = 20,
+        max_steps: int = DEFAULT_MAX_STEPS,
     ):
         """Initialize a new task with the given description.
 
@@ -89,7 +90,7 @@ class AsyncTask(AsyncActor):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
+        model: str = MODEL_ACTOR,
         temperature: float | None = None,
     ):
         warnings.warn(

oagi/task/async_short.py

@@ -8,6 +8,7 @@
 
 import warnings
 
+from ..constants import DEFAULT_MAX_STEPS, MODEL_ACTOR
 from ..logging import get_logger
 from ..types import AsyncActionHandler, AsyncImageProvider
 from .async_ import AsyncActor
@@ -27,7 +28,7 @@ class AsyncShortTask(AsyncActor, BaseAutoMode):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
+        model: str = MODEL_ACTOR,
         temperature: float | None = None,
     ):
         warnings.warn(
@@ -43,7 +44,7 @@ class AsyncShortTask(AsyncActor, BaseAutoMode):
     async def auto_mode(
         self,
         task_desc: str,
-        max_steps: int = 20,
+        max_steps: int = DEFAULT_MAX_STEPS,
         executor: AsyncActionHandler = None,
         image_provider: AsyncImageProvider = None,
         temperature: float | None = None,

oagi/task/base.py

@@ -8,6 +8,7 @@
 
 from uuid import uuid4
 
+from ..constants import DEFAULT_MAX_STEPS
 from ..logging import get_logger
 from ..types import URL, Image, Step
 from ..types.models import LLMResponse
@@ -30,7 +31,7 @@ class BaseActor:
         self.model = model
         self.temperature = temperature
         self.message_history: list = []  # OpenAI-compatible message history
-        self.max_steps: int = 20  # Maximum steps allowed
+        self.max_steps: int = DEFAULT_MAX_STEPS
         self.current_step: int = 0  # Current step counter
         # Client will be set by subclasses
         self.api_key: str | None = None

oagi/task/short.py

@@ -8,6 +8,7 @@
 
 import warnings
 
+from ..constants import DEFAULT_MAX_STEPS, MODEL_ACTOR
 from ..logging import get_logger
 from ..types import ActionHandler, ImageProvider
 from .base import BaseAutoMode
@@ -27,7 +28,7 @@ class ShortTask(Actor, BaseAutoMode):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
+        model: str = MODEL_ACTOR,
         temperature: float | None = None,
     ):
         warnings.warn(
@@ -43,7 +44,7 @@ class ShortTask(Actor, BaseAutoMode):
     def auto_mode(
         self,
         task_desc: str,
-        max_steps: int = 20,
+        max_steps: int = DEFAULT_MAX_STEPS,
         executor: ActionHandler = None,
         image_provider: ImageProvider = None,
         temperature: float | None = None,

oagi/task/sync.py

@@ -9,6 +9,7 @@
 import warnings
 
 from ..client import SyncClient
+from ..constants import DEFAULT_MAX_STEPS, MODEL_ACTOR
 from ..types import URL, Image, Step
 from .base import BaseActor
 
@@ -20,7 +21,7 @@ class Actor(BaseActor):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
+        model: str = MODEL_ACTOR,
         temperature: float | None = None,
     ):
         super().__init__(api_key, base_url, model, temperature)
@@ -31,7 +32,7 @@ class Actor(BaseActor):
     def init_task(
         self,
         task_desc: str,
-        max_steps: int = 20,
+        max_steps: int = DEFAULT_MAX_STEPS,
     ):
         """Initialize a new task with the given description.
 
@@ -87,7 +88,7 @@ class Task(Actor):
         self,
         api_key: str | None = None,
         base_url: str | None = None,
-        model: str = "lux-actor-1",
+        model: str = MODEL_ACTOR,
         temperature: float | None = None,
     ):
         warnings.warn(

{oagi_core-0.10.2.dist-info → oagi_core-0.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.10.2
+Version: 0.10.3
 Summary: Official API of OpenAGI Foundation
 Project-URL: Homepage, https://github.com/agiopen-org/oagi
 Author-email: OpenAGI Foundation <contact@agiopen.org>

{oagi_core-0.10.2.dist-info → oagi_core-0.10.3.dist-info}/RECORD

@@ -1,9 +1,10 @@
 oagi/__init__.py,sha256=xI--F3inDKuNQ2caI4Xx0rdFuUxO24cEeAX6WoGi170,4836
+oagi/constants.py,sha256=ZhlY_g3Z8w8njvoVykuGe3nty8A1LoGpRo5oJPh6qS0,1142
 oagi/exceptions.py,sha256=Rco37GQTPYUfc2vRO3hozxPF_s8mKFDpFvBg2UKWo3Y,3066
 oagi/logging.py,sha256=YT3KCMFj5fzO98R9xlDDgfSotUuz1xRD6OZeYM2rKoo,1760
 oagi/agent/__init__.py,sha256=KTVLUMhbjgpTJoOWMUZkkiqwhgumvbOZV2tJ9XCLfao,901
-oagi/agent/default.py,sha256=JZ4N2RRl0i5W60jumVg9j22XYWi9wn3yMFL92YVdpQA,4359
-oagi/agent/factories.py,sha256=QF-Ivey9yx2uDcVSHLXidM-gAPLj1L9jkoQ0tgGJFBw,2293
+oagi/agent/default.py,sha256=zHcTGyMv5QKE2tqwAsKsN6YyMWeSxCGCMzmv2PHdzMk,4520
+oagi/agent/factories.py,sha256=i-GIOEYmwBiiTq4W8UzKfZPkuZcMuOrlc_8dkxM1zLs,2727
 oagi/agent/protocol.py,sha256=IQJGiMN4yZIacrh5e9JQsoM9TyHb8wJRQR4LAk8dSA0,1615
 oagi/agent/registry.py,sha256=7bMA2-pH3xQ9ZavrHB_mnc2fOGSMeICPbOGtHoM7It0,4851
 oagi/agent/observer/__init__.py,sha256=YZ4qvR22pFB0mSDMX6iKKLbBA1dB-nqC7HZVvdMIVGw,909
@@ -15,40 +16,40 @@ oagi/agent/observer/report_template.html,sha256=NOp280_-P2g_4TYbtqPhYxv-y_x3Pwov
 oagi/agent/tasker/__init__.py,sha256=1iTEFe7lzcqh96TL9R0QADPpLJLrUP0shtZ4DlZSv_8,764
 oagi/agent/tasker/memory.py,sha256=NR13l5yxRA8GUE-oupAP4W1n80ZNG0SxpUfxsNltkUY,5033
 oagi/agent/tasker/models.py,sha256=sMQgwIMKhT1tvVF2yoc1hh8GwEiJ6i6qPMy9WoiA8JM,2137
-oagi/agent/tasker/planner.py,sha256=1NJQ2279GlGLMTB6JUhgnJtN46iiEGy2O_czaxRQwsE,14437
-oagi/agent/tasker/taskee_agent.py,sha256=X5pFcZIG3uE6p23c2FDdIUZtOnCgW0a9Sdt13NLR5-E,17040
-oagi/agent/tasker/tasker_agent.py,sha256=YrblKaTDTjiBt0N3_jDgmJAB7smSxvCJy_2nC9-vtnk,10920
+oagi/agent/tasker/planner.py,sha256=RxDilAGJAaC8gu9EkTwBATDLv7lQlzc3LMyxs0KMR74,14516
+oagi/agent/tasker/taskee_agent.py,sha256=MHl_ZH0p8fJ9iSG-VZe_4WUzdyjg4cLZbvEnccQcV2w,17263
+oagi/agent/tasker/tasker_agent.py,sha256=P0O4Ned8U0JfMFLWT2JCYXyfuHbU8XziPSotrRuNzMM,11157
 oagi/cli/__init__.py,sha256=aDnJViTseShpo5fdGPTj-ELysZhmdvB6Z8mEj2D-_N4,359
-oagi/cli/agent.py,sha256=fTqr50Q0QO9Gsy_P7iJcb4K7TaDeY3kUXTDQrePVlVQ,9756
-oagi/cli/display.py,sha256=rkAxuHa40ZtKdmvwARev1rgyfsNyVvQ-J6RdjOZIPwc,1729
+oagi/cli/agent.py,sha256=eFwdVZdZcG9ZTMupwoH_JqKSRKDAto3j3z4Xqz5XH7g,10225
+oagi/cli/display.py,sha256=Y8_Dn5RIEfRqZUHVGF6URItW0C3XC7bPLWoAmmhvBS0,1829
 oagi/cli/main.py,sha256=faHns0HaQCGyylDn2YZLpjQESuEiMYjoQVoMkt8FsH4,2292
-oagi/cli/server.py,sha256=Z1ic8r55yaeQBFRCsMNZStC1jRiJdnDGqe9On9LmFzQ,3031
+oagi/cli/server.py,sha256=JFpzCOeaftITxesz8Ya-_Efs03bgotBg7aYwmMZhPwU,3033
 oagi/cli/tracking.py,sha256=TdrAcNq_-OjgXltFCoFc8NsO_k6yHbdzHnMn3vAAvKA,1707
-oagi/cli/utils.py,sha256=BI6C7WvC51NBsXEsjDONjSNwqdD4i0nHA_rsfpyLwmA,2986
+oagi/cli/utils.py,sha256=zIkTrr-ai__3cGSaxiXY-OJs69Fcxd1sHb2FoeyHFtE,3034
 oagi/client/__init__.py,sha256=F9DShPUdb6vZYmN1fpM1VYzp4MWqUao_e_R1KYmM4Q4,410
-oagi/client/async_.py,sha256=iEOQun2kxW1iQ4h_TsSKqj-w3LviKLDxddXrteY61Fk,10894
-oagi/client/base.py,sha256=lczoKI1FqlqJbfAB6lAuXH2oDCVT-F0_LBVu6OS1pDo,16739
-oagi/client/sync.py,sha256=LPCG136BVzzL9yQOW7QdBiEXCDwRzzqL3GXnJHA6ui8,10730
+oagi/client/async_.py,sha256=Z8DyQHEl_XAyw1Fs0o3qQzEX9lGlZhqCTSEtQh5XHSw,11204
+oagi/client/base.py,sha256=tKYmhJufg7sqEOOp7nn0S9jv4hDYfM-pBuluh0pqew0,16756
+oagi/client/sync.py,sha256=CcesgCk_b26v_DF9OKpjfSHKSMjK0N2ywAxwaGnJ4fo,11040
 oagi/handler/__init__.py,sha256=Ha11L42K33K3L9S4lQ10UC0DnD5g6egtQUsJpS_tKgg,835
 oagi/handler/_macos.py,sha256=aHkp-xGzvWL_SBjuS690i9jf93OITFJfGHzHeYCK65I,1957
 oagi/handler/async_pyautogui_action_handler.py,sha256=hQzseR1yBD0QMpgsEVNsUmuApGVAIIyGYD06BXd82Dc,1615
 oagi/handler/async_screenshot_maker.py,sha256=8QCtUV59ozpOpvkqhUMb8QDI2qje2gsoFT1qB60tfJM,1689
 oagi/handler/pil_image.py,sha256=yUcAoGBL-aZ0PCjSaAmQsDwtyzjldXHqXQp_OYRk6e4,4080
-oagi/handler/pyautogui_action_handler.py,sha256=AIzxLCZipWlIP8wsJ4qtwhT-bp06KW5ly4FADl_odjQ,10559
+oagi/handler/pyautogui_action_handler.py,sha256=vxSkD_Xsshxb6cfoFFd_zpAwQm21cYTk4w1BGenKZes,10604
 oagi/handler/screenshot_maker.py,sha256=j1jTW-awx3vAnb1N5_FIMBC0Z-rNVQbiBP-S6Gh5dlE,1284
 oagi/server/__init__.py,sha256=uZx8u3vJUb87kkNzwmmVrgAgbqRu0WxyMIQCLSx56kk,452
 oagi/server/agent_wrappers.py,sha256=j8va0A7u80bzOM82nndAplK1uaO_T3kufHWScK6kfWM,3263
-oagi/server/config.py,sha256=2gJ-pDpYAxNUubwSsGKOieGcOtNX9b5YGuSqtf6g2P0,1607
+oagi/server/config.py,sha256=AJ1PLKuxrc6pRuur1hm5DwG2g2otxPwOCfKgzIACkSk,1691
 oagi/server/main.py,sha256=jnTxk7Prc5CzlsUnkBNJp4MOoYN-7HN_Be_m1d3COa8,4829
-oagi/server/models.py,sha256=7zsmjvnIZ0JUcCpE8F2A1OqX4_kGJydraRkbvPHnvn8,2593
-oagi/server/session_store.py,sha256=922Sz00_Ao-9fA0dhA1lrzs7yd6wo7xpdYJH4hZmEaI,3634
-oagi/server/socketio_server.py,sha256=9FNkx6K-ZbRWylHCKv8zrW0pkiKybDN5pWBANTnouts,14211
+oagi/server/models.py,sha256=DXjuf5icpCOgCUGMzzoLfRCoreM541KBWKBZnCk5_S0,2688
+oagi/server/session_store.py,sha256=319CDqGT9bnqaHK5JiLCG2mKxJmIbq1eH3BpjhWLxdI,3685
+oagi/server/socketio_server.py,sha256=0JUf8Y6r9Y7gmltznnsGsEeTp1FhT7AxohSHeBuH3R8,14233
 oagi/task/__init__.py,sha256=g_8_7ZLDLKuCGzyrB42OzY3gSOjd_SxzkJW3_pf-PXs,662
-oagi/task/async_.py,sha256=ev1jnuOQIYahjjMlSCFwtaeyOliePZCpEVt3ocsZXAI,3124
-oagi/task/async_short.py,sha256=VMIBKcTQMjadWXPHiJXWlYZqr5v4MeGVYnuKOs7dS3Y,2752
-oagi/task/base.py,sha256=D4e4N1cWoObMzaGcXyXGBPKyNbzmxABIjxbHiVrK548,5664
-oagi/task/short.py,sha256=xSR5_9BX35UMfITXtCgKXRLU92f4vnqa06c-HSjUO0A,2561
-oagi/task/sync.py,sha256=ciDkQYJQZkQyp8buNIKXU9Oy6kD7WIezCh2L0trLDDc,2958
+oagi/task/async_.py,sha256=12BrdE-51bEz2-PZv5X2VW__I_nwq2K1YxGfD3wFxos,3190
+oagi/task/async_short.py,sha256=wVMYpsKGbvqYIe2Ws7cMf8-t7SZKmtrgjW1x_RENMgg,2820
+oagi/task/base.py,sha256=6F_nmJsb2Zw6nUibJyAEW0uQBY_jHiQINUbd_jT5wkQ,5696
+oagi/task/short.py,sha256=D5VX8QGy0o8W7njy74jx95PxU0Rv2Nvoa-2T17aBaZQ,2629
+oagi/task/sync.py,sha256=pKRpIFcetm1n2BgmYGWQeWgV3kKLAQRG9xPlBVQ_pho,3024
 oagi/types/__init__.py,sha256=nhxQBaDssygtscetliQa3AaryvuNZhkVmBYsVcuR-qg,1332
 oagi/types/action_handler.py,sha256=NH8E-m5qpGqWcXzTSWfF7W0Xdp8SkzJsbhCmQ0B96cg,1075
 oagi/types/async_action_handler.py,sha256=k1AaqSkFcXlxwW8sn-w0WFHGsIqHFLbcOPrkknmSVug,1116
@@ -62,8 +63,8 @@ oagi/types/models/action.py,sha256=Q14xfYJrj9IsrqxDpEIzd6iWS-gLmNHfIX6Ef8k0O9E,2
 oagi/types/models/client.py,sha256=1xIKBgLSheHfqYbcyRKMDOLQJaKijaKQ5l-COc6e7_k,1471
 oagi/types/models/image_config.py,sha256=tl6abVg_-IAPLwpaWprgknXu7wRWriMg-AEVyUX73v0,1567
 oagi/types/models/step.py,sha256=RSI4H_2rrUBq_xyCoWKaq7JHdJWNobtQppaKC1l0aWU,471
-oagi_core-0.10.2.dist-info/METADATA,sha256=zEpy_q3jUhSphhGi6QYKkvjGvZKLnDq6QSPlOtJ8ppw,8269
-oagi_core-0.10.2.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-oagi_core-0.10.2.dist-info/entry_points.txt,sha256=zzgsOSWX6aN3KUB0Z1it8DMxFFBJBqmZVqMVAJRjYuw,44
-oagi_core-0.10.2.dist-info/licenses/LICENSE,sha256=sy5DLA2M29jFT4UfWsuBF9BAr3FnRkYtnAu6oDZiIf8,1075
-oagi_core-0.10.2.dist-info/RECORD,,
+oagi_core-0.10.3.dist-info/METADATA,sha256=XvsZ9dqWB1fDxdazYcT5u8-k9aeKqZBmtmmm_x0JEMo,8269
+oagi_core-0.10.3.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+oagi_core-0.10.3.dist-info/entry_points.txt,sha256=zzgsOSWX6aN3KUB0Z1it8DMxFFBJBqmZVqMVAJRjYuw,44
+oagi_core-0.10.3.dist-info/licenses/LICENSE,sha256=sy5DLA2M29jFT4UfWsuBF9BAr3FnRkYtnAu6oDZiIf8,1075
+oagi_core-0.10.3.dist-info/RECORD,,