Support title and reason keys in transport error extraction

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

Author: cursoragent

hyperbrowser/transport/error_utils.py

@@ -50,7 +50,7 @@ def _stringify_error_value(value: Any, *, _depth: int = 0) -> str:
     if isinstance(value, str):
         return value
     if isinstance(value, dict):
-        for key in ("message", "error", "detail", "errors", "msg"):
+        for key in ("message", "error", "detail", "errors", "msg", "title", "reason"):
             nested_value = value.get(key)
             if nested_value is not None:
                 return _stringify_error_value(nested_value, _depth=_depth + 1)
@@ -94,7 +94,7 @@ def _fallback_message() -> str:
 
     extracted_message: str
     if isinstance(error_data, dict):
-        for key in ("message", "error", "detail", "errors"):
+        for key in ("message", "error", "detail", "errors", "title", "reason"):
             message = error_data.get(key)
             if message is not None:
                 candidate_message = _stringify_error_value(message)

tests/test_transport_error_utils.py

@@ -303,6 +303,24 @@ def test_extract_error_message_extracts_errors_list_messages():
     assert message == "first issue; second issue"
 
 
+def test_extract_error_message_uses_title_field_when_present():
+    message = extract_error_message(
+        _DummyResponse({"title": "Request validation failed"}),
+        RuntimeError("fallback detail"),
+    )
+
+    assert message == "Request validation failed"
+
+
+def test_extract_error_message_uses_reason_field_when_present():
+    message = extract_error_message(
+        _DummyResponse({"reason": "service temporarily unavailable"}),
+        RuntimeError("fallback detail"),
+    )
+
+    assert message == "service temporarily unavailable"
+
+
 def test_extract_error_message_truncates_long_errors_lists():
     errors_payload = {"errors": [{"msg": f"issue-{index}"} for index in range(12)]}
     message = extract_error_message(