oagi-core 0.14.2__tar.gz → 0.15.0__tar.gz

{oagi_core-0.14.2 → oagi_core-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: oagi-core
-Version: 0.14.2
+Version: 0.15.0
 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.14.2 → oagi_core-0.15.0}/metapackage/pyproject.toml

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

{oagi_core-0.14.2 → oagi_core-0.15.0}/metapackage/uv.lock

@@ -527,18 +527,18 @@ wheels = [
 
 [[package]]
 name = "oagi"
-version = "0.14.2"
+version = "0.15.0"
 source = { editable = "." }
 dependencies = [
     { name = "oagi-core", extra = ["desktop", "server"] },
 ]
 
 [package.metadata]
-requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.14.1" }]
+requires-dist = [{ name = "oagi-core", extras = ["desktop", "server"], specifier = "==0.14.2" }]
 
 [[package]]
 name = "oagi-core"
-version = "0.14.1"
+version = "0.14.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -546,9 +546,9 @@ dependencies = [
     { name = "pydantic" },
     { name = "rich" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/94/20/3dfff9883e8786fc0b79ea915ba83cfbce3addd3149568601b80c3bc83a3/oagi_core-0.14.1.tar.gz", hash = "sha256:407faa59b3ced203901a1b35a5b3bc25407e8b61f82ab9b202f01412c73175bf", size = 310008, upload-time = "2026-01-23T08:09:08.54Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7f/6e/02d64ba32075a3977e1037228580d29de7122e8d5dce2a1267c71d8c3d69/oagi_core-0.14.2.tar.gz", hash = "sha256:2eda6ef21276dc0c7256b6014f8db7045eaedf98a6f091f0aedf3f44b20321e6", size = 319639, upload-time = "2026-02-03T07:42:15.596Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/62/d1/4485bbddbdf1868aa46deaa98d49ad4624e243c9b32321c81374402bcde8/oagi_core-0.14.1-py3-none-any.whl", hash = "sha256:36b0e10a79c0508eedd28f8a5d89230b7236452ed64bed7150b22f99a50f1a18", size = 114938, upload-time = "2026-01-23T08:09:07.4Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/90/62215c6e46961d29d6e9e715d89483d108a811f5c1c854a5bb7b053eacab/oagi_core-0.14.2-py3-none-any.whl", hash = "sha256:ceaeabbe20bafef7c031f3932d6870b42e7406173030790a5a55965b8ebe5f73", size = 124410, upload-time = "2026-02-03T07:42:14.23Z" },
 ]
 
 [package.optional-dependencies]

{oagi_core-0.14.2 → oagi_core-0.15.0}/pyproject.toml

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

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/converters/oagi.py

@@ -51,21 +51,21 @@ class OagiActionConverter(BaseActionConverter[Action]):
         """
         converted: list[str] = []
         failed: list[tuple[str, str]] = []
-        has_finish = False
+        has_terminal = False
 
         if not actions:
             return converted
 
         for action in actions:
-            # Check for duplicate finish() during iteration
-            is_finish = action.type == ActionType.FINISH
-            if is_finish:
-                if has_finish:
+            # Check for duplicate finish()/fail() during iteration
+            is_terminal = action.type in (ActionType.FINISH, ActionType.FAIL)
+            if is_terminal:
+                if has_terminal:
                     raise ValueError(
-                        "Duplicate finish() detected. "
-                        "Only one finish() is allowed per action sequence."
+                        "Duplicate finish()/fail() detected. "
+                        "Only one finish() or fail() is allowed per action sequence."
                     )
-                has_finish = True
+                has_terminal = True
 
             try:
                 converted.extend(self._convert_action(action))
@@ -172,6 +172,10 @@ class OagiActionConverter(BaseActionConverter[Action]):
             self._log_info("Task completion action -> DONE")
             return ["DONE"]
 
+        if action_type == ActionType.FAIL.value:
+            self._log_info("Task infeasible action -> FAIL")
+            return ["FAIL"]
+
         if action_type == ActionType.CALL_USER.value:
             self._log_info("User intervention requested")
             return []
@@ -179,7 +183,7 @@ class OagiActionConverter(BaseActionConverter[Action]):
         raise ValueError(
             f"Unknown action type: '{action_type}'. "
             "Supported: click, left_double, left_triple, right_single, drag, "
-            "hotkey, type, scroll, wait, finish, call_user"
+            "hotkey, type, scroll, wait, finish, fail, call_user"
         )
 
     def serialize_actions(self, actions: list[Action]) -> list[dict[str, Any]]:

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/handler/pyautogui_action_handler.py

@@ -250,8 +250,8 @@ class PyautoguiActionHandler:
                 )
                 pyautogui.scroll(scroll_amount)
 
-            case ActionType.FINISH:
-                # Task completion - reset handler state
+            case ActionType.FINISH | ActionType.FAIL:
+                # Task completion or infeasible - reset handler state
                 self.reset()
 
             case ActionType.WAIT:

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/handler/ydotool_action_handler.py

@@ -164,8 +164,8 @@ class YdotoolActionHandler(Ydotool):
                 text = self.caps_manager.transform_text(text)
                 self._run_ydotool(["type", text], count=count)
 
-            case ActionType.FINISH:
-                # Task completion - reset handler state
+            case ActionType.FINISH | ActionType.FAIL:
+                # Task completion or infeasible - reset handler state
                 self.reset()
 
             case ActionType.WAIT:

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/server/socketio_server.py

@@ -364,7 +364,7 @@ class SessionNamespace(socketio.AsyncNamespace):
                     timeout=self.config.socketio_timeout,
                 )
 
-            case ActionType.FINISH:
+            case ActionType.FINISH | ActionType.FAIL:
                 return await self.call(
                     "finish",
                     FinishEventData(**common).model_dump(),

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/types/models/action.py

@@ -22,6 +22,7 @@ class ActionType(str, Enum):
     TYPE = "type"
     SCROLL = "scroll"
     FINISH = "finish"
+    FAIL = "fail"
     WAIT = "wait"
     CALL_USER = "call_user"
 

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/utils/output_parser.py

@@ -45,7 +45,7 @@ def parse_raw_output(raw_output: str) -> Step:
             parsed_action = _parse_action(action_text.strip())
             if parsed_action:
                 actions.append(parsed_action)
-                if parsed_action.type == ActionType.FINISH:
+                if parsed_action.type in (ActionType.FINISH, ActionType.FAIL):
                     stop = True
 
     return Step(reason=reason, actions=actions, stop=stop)
@@ -105,6 +105,7 @@ def _parse_action(action_text: str) -> Action | None:
     - scroll(x, y, direction, c) # scroll at position
     - wait() # wait for a while
     - finish() # indicate task is finished
+    - fail() # indicate task is infeasible
 
     Args:
         action_text: String representation of a single action

{oagi_core-0.14.2 → oagi_core-0.15.0}/src/oagi/utils/prompt_builder.py

@@ -24,6 +24,7 @@ In the action field, you have the following action formats:
 8. scroll(x, y, direction, c) # scroll the mouse at position (x, y) in the direction of up or down for c times, where x and y are integers normalized between 0 and 1000
 9. wait() # wait for a while
 10. finish() # indicate the task is finished
+11. fail() # indicate the task is infeasible
 
 Directly output the text beginning with <|think_start|>, no additional text is needed for this scenario.
 

{oagi_core-0.14.2 → oagi_core-0.15.0}/tests/conftest.py

@@ -132,6 +132,12 @@ def sample_raw_output_completed():
     return "<|think_start|>The task has been completed successfully<|think_end|>\n<|action_start|>finish()<|action_end|>"
 
 
+@pytest.fixture
+def sample_raw_output_failed():
+    """Sample raw output for infeasible task."""
+    return "<|think_start|>The task is infeasible<|think_end|>\n<|action_start|>fail()<|action_end|>"
+
+
 @pytest.fixture
 def sample_step(sample_action):
     """Sample Step object for testing."""
@@ -152,6 +158,16 @@ def completed_step():
     )
 
 
+@pytest.fixture
+def failed_step():
+    """Sample failed Step object for infeasible task."""
+    return Step(
+        reason="The task is infeasible",
+        actions=[Action(type=ActionType.FAIL, argument="", count=1)],
+        stop=True,
+    )
+
+
 @pytest.fixture
 def mock_error_response():
     """Mock error HTTP response."""

{oagi_core-0.14.2 → oagi_core-0.15.0}/tests/test_actor.py

@@ -219,6 +219,27 @@ class TestActorStep:
         assert len(result.actions) == 1
         assert result.actions[0].type == ActionType.FINISH
 
+    def test_step_with_failed_response(
+        self, actor, failed_step, sample_usage_obj, mock_upload_file_response
+    ):
+        actor.task_description = "Test task"
+        actor.task_id = "task-789"
+
+        # Setup mocks
+        actor.client.put_s3_presigned_url.return_value = mock_upload_file_response
+        actor.client.chat_completion.return_value = (
+            failed_step,
+            "<|think_start|>infeasible<|think_end|>\n<|action_start|>fail()<|action_end|>",
+            sample_usage_obj,
+        )
+
+        result = actor.step(b"image bytes")
+
+        assert result.stop is True
+        assert result.reason == "The task is infeasible"
+        assert len(result.actions) == 1
+        assert result.actions[0].type == ActionType.FAIL
+
     def test_step_handles_exception(self, actor, mock_upload_file_response):
         actor.task_description = "Test task"
         actor.client.put_s3_presigned_url.return_value = mock_upload_file_response

{oagi_core-0.14.2 → oagi_core-0.15.0}/tests/test_oagi_action_converter.py

@@ -97,6 +97,19 @@ class TestSpecialActions:
         result = converter([action])
         assert result[0] == "DONE"
 
+    def test_fail_action(self, converter):
+        action = Action(type=ActionType.FAIL, argument="", count=1)
+        result = converter([action])
+        assert result[0] == "FAIL"
+
+    def test_duplicate_terminal_actions_raises(self, converter):
+        actions = [
+            Action(type=ActionType.FINISH, argument="", count=1),
+            Action(type=ActionType.FAIL, argument="", count=1),
+        ]
+        with pytest.raises(ValueError, match="Duplicate finish\\(\\)/fail\\(\\)"):
+            converter(actions)
+
 
 class TestActionStringToStep:
     def test_pyautogui_command(self, converter):
@@ -114,6 +127,11 @@ class TestActionStringToStep:
         assert step["type"] == "sleep"
         assert step["parameters"]["seconds"] == 0
 
+    def test_fail_command(self, converter):
+        step = converter.action_string_to_step("FAIL")
+        assert step["type"] == "sleep"
+        assert step["parameters"]["seconds"] == 0
+
 
 class TestMultipleActions:
     def test_action_count(self, converter):

{oagi_core-0.14.2 → oagi_core-0.15.0}/tests/test_pyautogui_action_handler.py

@@ -131,6 +131,11 @@ def test_finish_action(handler, mock_pyautogui):
     handler([action])
 
 
+def test_fail_action(handler, mock_pyautogui):
+    action = Action(type=ActionType.FAIL, argument="", count=1)
+    handler([action])
+
+
 def test_call_user_action(handler, mock_pyautogui, capsys):
     action = Action(type=ActionType.CALL_USER, argument="", count=1)
     handler([action])
@@ -453,6 +458,20 @@ class TestHandlerReset:
         handler([finish_action])
         assert handler.caps_manager.caps_enabled is False
 
+    def test_fail_action_resets_handler(self, mock_pyautogui):
+        config = PyautoguiConfig(capslock_mode="session", post_batch_delay=0)
+        handler = PyautoguiActionHandler(config=config)
+
+        # Enable caps lock
+        caps_action = Action(type=ActionType.HOTKEY, argument="capslock", count=1)
+        handler([caps_action])
+        assert handler.caps_manager.caps_enabled is True
+
+        # FAIL action should also reset handler
+        fail_action = Action(type=ActionType.FAIL, argument="", count=1)
+        handler([fail_action])
+        assert handler.caps_manager.caps_enabled is False
+
 
 class TestAsyncHandlerReset:
     def test_async_handler_reset_delegates_to_sync_handler(self, mock_pyautogui):

{oagi_core-0.14.2 → oagi_core-0.15.0}/tests/utils/test_output_parser.py

@@ -34,6 +34,15 @@ class TestParseRawOutput:
         assert step.actions[0].type == ActionType.FINISH
         assert step.stop is True
 
+    def test_parse_fail_action_sets_stop(self):
+        raw = "<|think_start|>Task is infeasible<|think_end|>\n<|action_start|>fail()<|action_end|>"
+        step = parse_raw_output(raw)
+
+        assert step.reason == "Task is infeasible"
+        assert len(step.actions) == 1
+        assert step.actions[0].type == ActionType.FAIL
+        assert step.stop is True
+
     def test_parse_multiple_actions_with_ampersand(self):
         raw = "<|think_start|>Do two things<|think_end|>\n<|action_start|>click(100, 200) & type(hello)<|action_end|>"
         step = parse_raw_output(raw)
@@ -147,6 +156,7 @@ class TestParseAction:
             ("type(hello world)", ActionType.TYPE, "hello world"),
             ("wait()", ActionType.WAIT, ""),
             ("finish()", ActionType.FINISH, ""),
+            ("fail()", ActionType.FAIL, ""),
         ],
     )
     def test_parse_basic_actions(self, action_text, expected_type, expected_arg):
@@ -254,3 +264,18 @@ class TestEdgeCases:
 
         assert step.stop is True
         assert len(step.actions) == 2
+
+    def test_fail_with_other_actions(self):
+        raw = "<|think_start|>Test<|think_end|>\n<|action_start|>click(100, 200) & fail()<|action_end|>"
+        step = parse_raw_output(raw)
+
+        assert step.stop is True
+        assert len(step.actions) == 2
+        assert step.actions[1].type == ActionType.FAIL
+
+    def test_multiple_fail_actions_stop_true(self):
+        raw = "<|think_start|>Test<|think_end|>\n<|action_start|>fail() & fail()<|action_end|>"
+        step = parse_raw_output(raw)
+
+        assert step.stop is True
+        assert len(step.actions) == 2

{oagi_core-0.14.2 → oagi_core-0.15.0}/uv.lock

@@ -544,7 +544,7 @@ wheels = [
 
 [[package]]
 name = "oagi-core"
-version = "0.14.2"
+version = "0.15.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },