Centralize agent start payload error metadata

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

hyperbrowser/client/managers/agent_operation_metadata.py

@@ -3,6 +3,7 @@
 
 @dataclass(frozen=True)
 class AgentOperationMetadata:
+    start_payload_error_message: str
     start_operation_name: str
     task_operation_name: str
     status_operation_name: str
@@ -12,6 +13,7 @@ class AgentOperationMetadata:
 
 
 BROWSER_USE_OPERATION_METADATA = AgentOperationMetadata(
+    start_payload_error_message="Failed to serialize browser-use start params",
     start_operation_name="browser-use start",
     task_operation_name="browser-use task",
     status_operation_name="browser-use task status",
@@ -21,6 +23,7 @@ class AgentOperationMetadata:
 )
 
 HYPER_AGENT_OPERATION_METADATA = AgentOperationMetadata(
+    start_payload_error_message="Failed to serialize HyperAgent start params",
     start_operation_name="hyper agent start",
     task_operation_name="hyper agent task",
     status_operation_name="hyper agent task status",
@@ -30,6 +33,7 @@ class AgentOperationMetadata:
 )
 
 GEMINI_COMPUTER_USE_OPERATION_METADATA = AgentOperationMetadata(
+    start_payload_error_message="Failed to serialize Gemini Computer Use start params",
     start_operation_name="gemini computer use start",
     task_operation_name="gemini computer use task",
     status_operation_name="gemini computer use task status",
@@ -39,6 +43,7 @@ class AgentOperationMetadata:
 )
 
 CLAUDE_COMPUTER_USE_OPERATION_METADATA = AgentOperationMetadata(
+    start_payload_error_message="Failed to serialize Claude Computer Use start params",
     start_operation_name="claude computer use start",
     task_operation_name="claude computer use task",
     status_operation_name="claude computer use task status",
@@ -48,6 +53,7 @@ class AgentOperationMetadata:
 )
 
 CUA_OPERATION_METADATA = AgentOperationMetadata(
+    start_payload_error_message="Failed to serialize CUA start params",
     start_operation_name="cua start",
     task_operation_name="cua task",
     status_operation_name="cua task status",

hyperbrowser/client/managers/async_manager/agents/claude_computer_use.py

@@ -36,7 +36,7 @@ async def start(
     ) -> StartClaudeComputerUseTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize Claude Computer Use start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return await start_agent_task_async(
             client=self._client,

hyperbrowser/client/managers/async_manager/agents/cua.py

@@ -34,7 +34,7 @@ def __init__(self, client):
     async def start(self, params: StartCuaTaskParams) -> StartCuaTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize CUA start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return await start_agent_task_async(
             client=self._client,

hyperbrowser/client/managers/async_manager/agents/gemini_computer_use.py

@@ -36,7 +36,7 @@ async def start(
     ) -> StartGeminiComputerUseTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize Gemini Computer Use start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return await start_agent_task_async(
             client=self._client,

hyperbrowser/client/managers/async_manager/agents/hyper_agent.py

@@ -36,7 +36,7 @@ async def start(
     ) -> StartHyperAgentTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize HyperAgent start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return await start_agent_task_async(
             client=self._client,

hyperbrowser/client/managers/sync_manager/agents/claude_computer_use.py

@@ -36,7 +36,7 @@ def start(
     ) -> StartClaudeComputerUseTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize Claude Computer Use start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return start_agent_task(
             client=self._client,

hyperbrowser/client/managers/sync_manager/agents/cua.py

@@ -34,7 +34,7 @@ def __init__(self, client):
     def start(self, params: StartCuaTaskParams) -> StartCuaTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize CUA start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return start_agent_task(
             client=self._client,

hyperbrowser/client/managers/sync_manager/agents/gemini_computer_use.py

@@ -36,7 +36,7 @@ def start(
     ) -> StartGeminiComputerUseTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize Gemini Computer Use start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return start_agent_task(
             client=self._client,

hyperbrowser/client/managers/sync_manager/agents/hyper_agent.py

@@ -34,7 +34,7 @@ def __init__(self, client):
     def start(self, params: StartHyperAgentTaskParams) -> StartHyperAgentTaskResponse:
         payload = build_agent_start_payload(
             params,
-            error_message="Failed to serialize HyperAgent start params",
+            error_message=self._OPERATION_METADATA.start_payload_error_message,
         )
         return start_agent_task(
             client=self._client,

tests/test_agent_operation_metadata.py

@@ -8,6 +8,10 @@
 
 
 def test_browser_use_operation_metadata_values():
+    assert (
+        BROWSER_USE_OPERATION_METADATA.start_payload_error_message
+        == "Failed to serialize browser-use start params"
+    )
     assert BROWSER_USE_OPERATION_METADATA.start_operation_name == "browser-use start"
     assert BROWSER_USE_OPERATION_METADATA.task_operation_name == "browser-use task"
     assert (
@@ -25,6 +29,10 @@ def test_browser_use_operation_metadata_values():
 
 
 def test_hyper_agent_operation_metadata_values():
+    assert (
+        HYPER_AGENT_OPERATION_METADATA.start_payload_error_message
+        == "Failed to serialize HyperAgent start params"
+    )
     assert HYPER_AGENT_OPERATION_METADATA.start_operation_name == "hyper agent start"
     assert HYPER_AGENT_OPERATION_METADATA.task_operation_name == "hyper agent task"
     assert (
@@ -40,6 +48,10 @@ def test_hyper_agent_operation_metadata_values():
 
 
 def test_gemini_operation_metadata_values():
+    assert (
+        GEMINI_COMPUTER_USE_OPERATION_METADATA.start_payload_error_message
+        == "Failed to serialize Gemini Computer Use start params"
+    )
     assert (
         GEMINI_COMPUTER_USE_OPERATION_METADATA.start_operation_name
         == "gemini computer use start"
@@ -67,6 +79,10 @@ def test_gemini_operation_metadata_values():
 
 
 def test_claude_operation_metadata_values():
+    assert (
+        CLAUDE_COMPUTER_USE_OPERATION_METADATA.start_payload_error_message
+        == "Failed to serialize Claude Computer Use start params"
+    )
     assert (
         CLAUDE_COMPUTER_USE_OPERATION_METADATA.start_operation_name
         == "claude computer use start"
@@ -94,6 +110,10 @@ def test_claude_operation_metadata_values():
 
 
 def test_cua_operation_metadata_values():
+    assert (
+        CUA_OPERATION_METADATA.start_payload_error_message
+        == "Failed to serialize CUA start params"
+    )
     assert CUA_OPERATION_METADATA.start_operation_name == "cua start"
     assert CUA_OPERATION_METADATA.task_operation_name == "cua task"
     assert CUA_OPERATION_METADATA.status_operation_name == "cua task status"