feat(api): manual updates

adding platform error codes

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-d3d485104a1c344076e6268935d0a5371036c95885b3fa6200c635f1351d2e25.yml
-openapi_spec_hash: 34c237455d4b5b60f9db14068d1a9999
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-39e18bbb8b0af73eca7a880f56afbdecd69e3e5bab82a04c4d6429c32d7e6727.yml
+openapi_spec_hash: 7a0de988bb37416d6e80f4a4bbe9d0d0
 config_hash: 0884847870200ee9d34bb00ce94aaa8e

src/oz_agent_sdk/resources/agent/runs.py

@@ -204,7 +204,11 @@ def cancel(
         """Cancel an agent run that is currently queued or in progress.
 
         Once cancelled, the
-        run will transition to a failed state.
+        run will transition to a cancelled state.
+
+        Not all runs can be cancelled. Runs that are in a terminal state (SUCCEEDED,
+        FAILED, ERROR, BLOCKED, CANCELLED) return 400. Runs in PENDING state return 409
+        (retry after a moment). Self-hosted, local, and GitHub Action runs return 422.
 
         Args:
           extra_headers: Send extra headers
@@ -402,7 +406,11 @@ async def cancel(
         """Cancel an agent run that is currently queued or in progress.
 
         Once cancelled, the
-        run will transition to a failed state.
+        run will transition to a cancelled state.
+
+        Not all runs can be cancelled. Runs that are in a terminal state (SUCCEEDED,
+        FAILED, ERROR, BLOCKED, CANCELLED) return 400. Runs in PENDING state return 409
+        (retry after a moment). Self-hosted, local, and GitHub Action runs return 422.
 
         Args:
           extra_headers: Send extra headers

src/oz_agent_sdk/types/agent/run_item.py

@@ -2,6 +2,7 @@
 
 from typing import List, Optional
 from datetime import datetime
+from typing_extensions import Literal
 
 from ..scope import Scope
 from ..._models import BaseModel
@@ -59,9 +60,71 @@ class Schedule(BaseModel):
 
 
 class StatusMessage(BaseModel):
-    message: Optional[str] = None
+    """Status message for a run.
+
+    For terminal error states, includes structured
+    error code and retryability info from the platform error catalog.
+    """
+
+    message: str
     """Human-readable status message"""
 
+    error_code: Optional[
+        Literal[
+            "insufficient_credits",
+            "feature_not_available",
+            "external_authentication_required",
+            "not_authorized",
+            "invalid_request",
+            "resource_not_found",
+            "budget_exceeded",
+            "integration_disabled",
+            "integration_not_configured",
+            "operation_not_supported",
+            "environment_setup_failed",
+            "content_policy_violation",
+            "conflict",
+            "authentication_required",
+            "resource_unavailable",
+            "internal_error",
+        ]
+    ] = None
+    """
+    Machine-readable error code identifying the problem type. Used in the `type` URI
+    of Error responses and in the `error_code` field of RunStatusMessage.
+
+    User errors (run transitions to FAILED):
+
+    - `insufficient_credits` — Team has no remaining add-on credits
+    - `feature_not_available` — Required feature not enabled for user's plan
+    - `external_authentication_required` — User hasn't authorized a required
+      external service
+    - `not_authorized` — Principal lacks permission for the requested operation
+    - `invalid_request` — Request is malformed or contains invalid parameters
+    - `resource_not_found` — Referenced resource does not exist
+    - `budget_exceeded` — Spending budget limit has been reached
+    - `integration_disabled` — Integration is disabled and must be enabled
+    - `integration_not_configured` — Integration setup is incomplete
+    - `operation_not_supported` — Requested operation not supported for this
+      resource/state
+    - `environment_setup_failed` — Client-side environment setup failed
+    - `content_policy_violation` — Prompt or setup commands violated content policy
+    - `conflict` — Request conflicts with the current state of the resource
+
+    Warp errors (run transitions to ERROR):
+
+    - `authentication_required` — Request lacks valid authentication credentials
+    - `resource_unavailable` — Transient infrastructure issue (retryable)
+    - `internal_error` — Unexpected server-side error (retryable)
+    """
+
+    retryable: Optional[bool] = None
+    """Whether the error is transient and the client may retry by submitting a new run.
+
+    Only present on terminal error states. When false, retrying without addressing
+    the underlying cause will not succeed.
+    """
+
 
 class RunItem(BaseModel):
     created_at: datetime
@@ -155,3 +218,8 @@ class RunItem(BaseModel):
     """Timestamp when the agent started working on the run (RFC3339)"""
 
     status_message: Optional[StatusMessage] = None
+    """Status message for a run.
+
+    For terminal error states, includes structured error code and retryability info
+    from the platform error catalog.
+    """