feat(api): journey run steps return error and skip_reason

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "trycourier"
-version = "9.12.0"
+version = "9.11.0"
 description = "The official Python library for the Courier API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/courier/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "courier"
-__version__ = "9.12.0"  # x-release-please-version
+__version__ = "9.11.0"  # x-release-please-version

src/courier/types/journey_run_step.py

@@ -4,7 +4,18 @@
 
 from .._models import BaseModel
 
-__all__ = ["JourneyRunStep"]
+__all__ = ["JourneyRunStep", "Error"]
+
+
+class Error(BaseModel):
+    """Why the step failed. Set when `status` is `ERROR`, `null` otherwise."""
+
+    message: str
+    """The reason, e.g.
+
+    `Fetch failed: GET api.example.com returned 404` or
+    `AI step timed out after 15 minutes`.
+    """
 
 
 class JourneyRunStep(BaseModel):
@@ -16,6 +27,15 @@ class JourneyRunStep(BaseModel):
     action: str
     """The kind of node that ran, e.g. `send`, `delay`, or `exit`."""
 
+    error: Optional[Error] = None
+    """Why the step failed. Set when `status` is `ERROR`, `null` otherwise."""
+
+    skip_reason: Optional[str] = None
+    """Why the step was skipped, e.g.
+
+    `Node conditions not met`. Set when `status` is `SKIPPED`, `null` otherwise.
+    """
+
     status: str
     """The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.