oneshot-python 0.26.0__tar.gz → 0.27.0__tar.gz

{oneshot_python-0.26.0 → oneshot_python-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oneshot-python
-Version: 0.26.0
+Version: 0.27.0
 Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 43 tools
 License-Expression: MIT
 Requires-Python: >=3.10

{oneshot_python-0.26.0 → oneshot_python-0.27.0}/oneshot/_errors.py

@@ -33,12 +33,18 @@ class PaymentError(OneShotError):
         expected: dict | None = None,
         received: dict | None = None,
         quote_id: str | None = None,
+        payment_attempt_id: str | None = None,
+        stage: str | None = None,
+        diagnostics: dict | None = None,
     ) -> None:
         super().__init__(message)
         self.reason = reason
         self.expected = expected or {}
         self.received = received or {}
         self.quote_id = quote_id
+        self.payment_attempt_id = payment_attempt_id
+        self.stage = stage
+        self.diagnostics = diagnostics
 
 
 class JobError(OneShotError):

{oneshot_python-0.26.0 → oneshot_python-0.27.0}/oneshot/client.py

@@ -56,7 +56,7 @@ try:
 
     SDK_VERSION = _pkg_version("oneshot-python")
 except Exception:  # pragma: no cover - editable/source runs without dist metadata
-    SDK_VERSION = "0.26.0"
+    SDK_VERSION = "0.27.0"
 
 # ---------------------------------------------------------------------------
 # Environment configuration
@@ -206,13 +206,13 @@ def _parse_payment_rejection(resp: Any) -> Optional[PaymentError]:
     payment is refused. Returns None for any other response so the caller can
     fall back to ``ToolError``.
     """
-    if resp.status_code != 402:
+    if resp.status_code not in (402, 500):
         return None
     try:
         data = resp.json()
     except Exception:  # noqa: BLE001 - non-JSON body
         return None
-    if not isinstance(data, dict) or data.get("error") != "payment_verification_failed":
+    if not isinstance(data, dict) or data.get("error") not in ("payment_verification_failed", "payment_processing_error"):
         return None
 
     reason = data.get("reason") or "unknown"
@@ -230,6 +230,9 @@ def _parse_payment_rejection(resp: Any) -> Optional[PaymentError]:
     if data.get("message"):
         message += f" ({data['message']})"
 
+    if data.get("payment_attempt_id"):
+        message += f" [payment attempt {data['payment_attempt_id']}]"
+
     return PaymentError(
         message,
         reason,
@@ -241,6 +244,9 @@ def _parse_payment_rejection(resp: Any) -> Optional[PaymentError]:
         },
         received={"amount": received.get("amount")},
         quote_id=data.get("quote_id"),
+        payment_attempt_id=data.get("payment_attempt_id"),
+        stage=data.get("stage"),
+        diagnostics=data.get("diagnostics"),
     )
 
 

{oneshot_python-0.26.0 → oneshot_python-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oneshot-python"
-version = "0.26.0"
+version = "0.27.0"
 description = "Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 43 tools"
 readme = {text = "Core Python SDK for the OneShot API", content-type = "text/plain"}
 license = "MIT"

{oneshot_python-0.26.0 → oneshot_python-0.27.0}/tests/test_payment_rejection.py

@@ -86,3 +86,25 @@ class TestParsePaymentRejection:
         err = _parse_payment_rejection(_Resp(402, REJECTION))
         assert isinstance(err, OneShotError)
         assert isinstance(err, Exported)
+
+
+def test_diagnostics_and_attempt_correlation():
+    diagnostics = {"status": "complete", "findings": [{"code": "unknown"}]}
+    error = _parse_payment_rejection(_Resp(402, {
+        **REJECTION, "payment_attempt_id": "attempt-123", "stage": "verification", "diagnostics": diagnostics,
+    }))
+    assert error.payment_attempt_id == "attempt-123"
+    assert "attempt-123" in str(error)
+    assert error.stage == "verification"
+    assert error.diagnostics == diagnostics
+    assert PaymentError("old", "unknown").diagnostics is None
+
+
+def test_transport_and_settlement_correlation():
+    error = _parse_payment_rejection(_Resp(500, {
+        "error": "payment_processing_error", "payment_attempt_id": "transport-123", "stage": "verification_transport",
+    }))
+    assert error.payment_attempt_id == "transport-123"
+    assert error.stage == "verification_transport"
+    error = _parse_payment_rejection(_Resp(402, {**REJECTION, "stage": "settlement"}))
+    assert error.stage == "settlement"

{oneshot_python-0.26.0 → oneshot_python-0.27.0}/uv.lock

@@ -549,7 +549,7 @@ wheels = [
 
 [[package]]
 name = "oneshot-python"
-version = "0.24.0"
+version = "0.27.0"
 source = { editable = "." }
 dependencies = [
     { name = "eth-account" },