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/resources/agent/runs.ts

@@ -38,7 +38,11 @@ export class Runs extends APIResource {
 
   /**
    * 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.
    *
    * @example
    * ```ts
@@ -271,6 +275,10 @@ export interface RunItem {
    */
   started_at?: string | null;
 
+  /**
+   * Status message for a run. For terminal error states, includes structured error
+   * code and retryability info from the platform error catalog.
+   */
   status_message?: RunItem.StatusMessage;
 }
 
@@ -337,11 +345,68 @@ export namespace RunItem {
     schedule_name: string;
   }
 
+  /**
+   * Status message for a run. For terminal error states, includes structured error
+   * code and retryability info from the platform error catalog.
+   */
   export interface StatusMessage {
     /**
      * Human-readable status message
      */
-    message?: string;
+    message: string;
+
+    /**
+     * 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)
+     */
+    error_code?:
+      | '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';
+
+    /**
+     * 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.
+     */
+    retryable?: boolean;
   }
 }