Harden extension key diagnostics for unprintable keys

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

Author: cursoragent

hyperbrowser/client/managers/extension_utils.py

@@ -9,13 +9,22 @@ def _get_type_name(value: Any) -> str:
     return type(value).__name__
 
 
+def _safe_stringify_key(value: object) -> str:
+    try:
+        return str(value)
+    except Exception:
+        return f"<unprintable {_get_type_name(value)}>"
+
+
 def parse_extension_list_response_data(response_data: Any) -> List[ExtensionResponse]:
     if not isinstance(response_data, Mapping):
         raise HyperbrowserError(
             f"Expected mapping response but got {_get_type_name(response_data)}"
         )
     if "extensions" not in response_data:
-        available_keys = ", ".join(sorted(str(key) for key in response_data.keys()))
+        available_keys = ", ".join(
+            sorted(_safe_stringify_key(key) for key in response_data.keys())
+        )
         if available_keys:
             available_keys = f"[{available_keys}]"
         else:

tests/test_extension_utils.py

@@ -115,3 +115,18 @@ def test_parse_extension_list_response_data_missing_key_lists_available_keys():
                 "updatedAt": "2026-01-01T00:00:00Z",
             }
         )
+
+
+def test_parse_extension_list_response_data_missing_key_handles_unprintable_keys():
+    class _BrokenStringKey:
+        def __str__(self) -> str:
+            raise RuntimeError("bad key stringification")
+
+    with pytest.raises(
+        HyperbrowserError,
+        match=(
+            "Expected 'extensions' key in response but got "
+            "\\[<unprintable _BrokenStringKey>\\] keys"
+        ),
+    ):
+        parse_extension_list_response_data({_BrokenStringKey(): "value"})