avtomatika-worker 1.0b4__tar.gz → 1.0b5__tar.gz

{avtomatika_worker-1.0b4/src/avtomatika_worker.egg-info → avtomatika_worker-1.0b5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: avtomatika-worker
-Version: 1.0b4
+Version: 1.0b5
 Summary: Worker SDK for the Avtomatika orchestrator.
 Author-email: Dmitrii Gagarin <madgagarin@gmail.com>
 Project-URL: Homepage, https://github.com/avtomatika-ai/avtomatika-worker
@@ -302,6 +302,7 @@ Each handler is a function (either `async def` or `def`) that accepts two argume
     -   `task_id` (`str`): The unique ID of the task itself.
     -   `job_id` (`str`): The ID of the parent `Job` to which the task belongs.
     -   `priority` (`int`): The execution priority of the task.
+    -   `send_progress` (`callable`): An async function `await send_progress(progress_float, message_string)` to report task execution progress (0.0 to 1.0) to the orchestrator.
 
 **Synchronous Handlers:**
 If you define your handler as a standard synchronous function (`def handler(...)`), the SDK will automatically execute it in a separate thread using `asyncio.to_thread`. This ensures that CPU-intensive operations (like model inference) do not block the worker's main event loop, allowing heartbeats and other background tasks to continue running smoothly.
@@ -404,7 +405,7 @@ return {
 
 #### Error Handling
 
-To control the orchestrator's fault tolerance mechanism, you can return standardized error types.
+To control the orchestrator's fault tolerance mechanism, you can return standardized error types. All error constants can be imported from `avtomatika_worker.typing`.
 
 -   **Transient Error (`TRANSIENT_ERROR`)**: For issues that might be resolved on a retry (e.g., a network failure).
     ```python
@@ -417,17 +418,10 @@ To control the orchestrator's fault tolerance mechanism, you can return standard
         }
     }
     ```
--   **Permanent Error (`PERMANENT_ERROR`)**: For unresolvable problems (e.g., an invalid file format).
-    ```python
-    from avtomatika_worker.typing import PERMANENT_ERROR
-    return {
-        "status": "failure",
-        "error": {
-            "code": PERMANENT_ERROR,
-            "message": "Corrupted input file"
-        }
-    }
-    ```
+-   **Permanent Error (`PERMANENT_ERROR`)**: For unresolvable problems (e.g., an invalid file format). Causes immediate quarantine.
+-   **Security Error (`SECURITY_ERROR`)**: For security violations. Causes immediate quarantine.
+-   **Dependency Error (`DEPENDENCY_ERROR`)**: For missing models or tools. Causes immediate quarantine.
+-   **Resource Exhausted (`RESOURCE_EXHAUSTED_ERROR`)**: When resources are temporarily unavailable. Treated as transient (retried).
 
 ### 4. Failover and Load Balancing
 

{avtomatika_worker-1.0b4 → avtomatika_worker-1.0b5}/README.md

@@ -269,6 +269,7 @@ Each handler is a function (either `async def` or `def`) that accepts two argume
     -   `task_id` (`str`): The unique ID of the task itself.
     -   `job_id` (`str`): The ID of the parent `Job` to which the task belongs.
     -   `priority` (`int`): The execution priority of the task.
+    -   `send_progress` (`callable`): An async function `await send_progress(progress_float, message_string)` to report task execution progress (0.0 to 1.0) to the orchestrator.
 
 **Synchronous Handlers:**
 If you define your handler as a standard synchronous function (`def handler(...)`), the SDK will automatically execute it in a separate thread using `asyncio.to_thread`. This ensures that CPU-intensive operations (like model inference) do not block the worker's main event loop, allowing heartbeats and other background tasks to continue running smoothly.
@@ -371,7 +372,7 @@ return {
 
 #### Error Handling
 
-To control the orchestrator's fault tolerance mechanism, you can return standardized error types.
+To control the orchestrator's fault tolerance mechanism, you can return standardized error types. All error constants can be imported from `avtomatika_worker.typing`.
 
 -   **Transient Error (`TRANSIENT_ERROR`)**: For issues that might be resolved on a retry (e.g., a network failure).
     ```python
@@ -384,17 +385,10 @@ To control the orchestrator's fault tolerance mechanism, you can return standard
         }
     }
     ```
--   **Permanent Error (`PERMANENT_ERROR`)**: For unresolvable problems (e.g., an invalid file format).
-    ```python
-    from avtomatika_worker.typing import PERMANENT_ERROR
-    return {
-        "status": "failure",
-        "error": {
-            "code": PERMANENT_ERROR,
-            "message": "Corrupted input file"
-        }
-    }
-    ```
+-   **Permanent Error (`PERMANENT_ERROR`)**: For unresolvable problems (e.g., an invalid file format). Causes immediate quarantine.
+-   **Security Error (`SECURITY_ERROR`)**: For security violations. Causes immediate quarantine.
+-   **Dependency Error (`DEPENDENCY_ERROR`)**: For missing models or tools. Causes immediate quarantine.
+-   **Resource Exhausted (`RESOURCE_EXHAUSTED_ERROR`)**: When resources are temporarily unavailable. Treated as transient (retried).
 
 ### 4. Failover and Load Balancing
 

{avtomatika_worker-1.0b4 → avtomatika_worker-1.0b5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "avtomatika-worker"
-version = "1.0b4"
+version = "1.0b5"
 description = "Worker SDK for the Avtomatika orchestrator."
 readme = "README.md"
 requires-python = ">=3.11"

{avtomatika_worker-1.0b4 → avtomatika_worker-1.0b5}/src/avtomatika_worker/types.py

@@ -1,11 +1,26 @@
 from typing import Any, Awaitable, Callable, Dict
 
+from rxon.constants import (
+    ERROR_CODE_DEPENDENCY as DEPENDENCY_ERROR,
+)
+from rxon.constants import (
+    ERROR_CODE_INTERNAL as INTERNAL_ERROR,
+)
 from rxon.constants import (
     ERROR_CODE_INVALID_INPUT as INVALID_INPUT_ERROR,
 )
 from rxon.constants import (
     ERROR_CODE_PERMANENT as PERMANENT_ERROR,
 )
+from rxon.constants import (
+    ERROR_CODE_RESOURCE_EXHAUSTED as RESOURCE_EXHAUSTED_ERROR,
+)
+from rxon.constants import (
+    ERROR_CODE_SECURITY as SECURITY_ERROR,
+)
+from rxon.constants import (
+    ERROR_CODE_TIMEOUT as TIMEOUT_ERROR,
+)
 from rxon.constants import (
     ERROR_CODE_TRANSIENT as TRANSIENT_ERROR,
 )
@@ -22,5 +37,10 @@ __all__ = [
     "INVALID_INPUT_ERROR",
     "PERMANENT_ERROR",
     "TRANSIENT_ERROR",
+    "RESOURCE_EXHAUSTED_ERROR",
+    "SECURITY_ERROR",
+    "DEPENDENCY_ERROR",
+    "TIMEOUT_ERROR",
+    "INTERNAL_ERROR",
     "ParamValidationError",
 ]

{avtomatika_worker-1.0b4 → avtomatika_worker-1.0b5/src/avtomatika_worker.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: avtomatika-worker
-Version: 1.0b4
+Version: 1.0b5
 Summary: Worker SDK for the Avtomatika orchestrator.
 Author-email: Dmitrii Gagarin <madgagarin@gmail.com>
 Project-URL: Homepage, https://github.com/avtomatika-ai/avtomatika-worker
@@ -302,6 +302,7 @@ Each handler is a function (either `async def` or `def`) that accepts two argume
     -   `task_id` (`str`): The unique ID of the task itself.
     -   `job_id` (`str`): The ID of the parent `Job` to which the task belongs.
     -   `priority` (`int`): The execution priority of the task.
+    -   `send_progress` (`callable`): An async function `await send_progress(progress_float, message_string)` to report task execution progress (0.0 to 1.0) to the orchestrator.
 
 **Synchronous Handlers:**
 If you define your handler as a standard synchronous function (`def handler(...)`), the SDK will automatically execute it in a separate thread using `asyncio.to_thread`. This ensures that CPU-intensive operations (like model inference) do not block the worker's main event loop, allowing heartbeats and other background tasks to continue running smoothly.
@@ -404,7 +405,7 @@ return {
 
 #### Error Handling
 
-To control the orchestrator's fault tolerance mechanism, you can return standardized error types.
+To control the orchestrator's fault tolerance mechanism, you can return standardized error types. All error constants can be imported from `avtomatika_worker.typing`.
 
 -   **Transient Error (`TRANSIENT_ERROR`)**: For issues that might be resolved on a retry (e.g., a network failure).
     ```python
@@ -417,17 +418,10 @@ To control the orchestrator's fault tolerance mechanism, you can return standard
         }
     }
     ```
--   **Permanent Error (`PERMANENT_ERROR`)**: For unresolvable problems (e.g., an invalid file format).
-    ```python
-    from avtomatika_worker.typing import PERMANENT_ERROR
-    return {
-        "status": "failure",
-        "error": {
-            "code": PERMANENT_ERROR,
-            "message": "Corrupted input file"
-        }
-    }
-    ```
+-   **Permanent Error (`PERMANENT_ERROR`)**: For unresolvable problems (e.g., an invalid file format). Causes immediate quarantine.
+-   **Security Error (`SECURITY_ERROR`)**: For security violations. Causes immediate quarantine.
+-   **Dependency Error (`DEPENDENCY_ERROR`)**: For missing models or tools. Causes immediate quarantine.
+-   **Resource Exhausted (`RESOURCE_EXHAUSTED_ERROR`)**: When resources are temporarily unavailable. Treated as transient (retried).
 
 ### 4. Failover and Load Balancing