include network error

Author: SentienceDEV

sentience/backends/snapshot.py

@@ -621,6 +621,15 @@ async def _snapshot_via_api(
         # Re-raise validation errors as-is
         raise
     except Exception as e:
+        # Preserve structured gateway details when available.
+        try:
+            from ..snapshot import SnapshotGatewayError  # type: ignore
+
+            if isinstance(e, SnapshotGatewayError):
+                raise
+        except Exception:
+            pass
+
         # Fallback to local extension on API error
         # This matches the behavior of the main snapshot function
         raise RuntimeError(

sentience/snapshot.py

@@ -96,6 +96,16 @@ def from_httpx(cls, e: Exception) -> "SnapshotGatewayError":
         body_snip = cls._snip(body)
         if body_snip:
             bits.append(f"body={body_snip}")
+        # If we don't have an HTTP status/response body, this is usually a transport error
+        # (timeout, DNS, connection reset). Preserve at least the exception type + message.
+        if status_code is None and not body_snip:
+            try:
+                err_s = cls._snip(str(e), 220)
+            except Exception:
+                err_s = None
+            bits.append(f"err_type={type(e).__name__}")
+            if err_s:
+                bits.append(f"err={err_s}")
         if bits:
             msg = f"{msg}: " + " ".join(bits)
         msg = msg + ". Try using use_api=False to use local extension instead."
@@ -144,6 +154,14 @@ def from_requests(cls, e: Exception) -> "SnapshotGatewayError":
         body_snip = cls._snip(body)
         if body_snip:
             bits.append(f"body={body_snip}")
+        if status_code is None and not body_snip:
+            try:
+                err_s = cls._snip(str(e), 220)
+            except Exception:
+                err_s = None
+            bits.append(f"err_type={type(e).__name__}")
+            if err_s:
+                bits.append(f"err={err_s}")
         if bits:
             msg = f"{msg}: " + " ".join(bits)
         msg = msg + ". Try using use_api=False to use local extension instead."