feat(api): error and error_code as types

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-39e18bbb8b0af73eca7a880f56afbdecd69e3e5bab82a04c4d6429c32d7e6727.yml
 openapi_spec_hash: 7a0de988bb37416d6e80f4a4bbe9d0d0
-config_hash: 0884847870200ee9d34bb00ce94aaa8e
+config_hash: 38ab203e1bd97a9bb22bbf744bcb5808

api.md

@@ -5,6 +5,8 @@ Types:
 - <code><a href="./src/resources/agent/agent.ts">AgentSkill</a></code>
 - <code><a href="./src/resources/agent/agent.ts">AmbientAgentConfig</a></code>
 - <code><a href="./src/resources/agent/agent.ts">CloudEnvironmentConfig</a></code>
+- <code><a href="./src/resources/agent/agent.ts">Error</a></code>
+- <code><a href="./src/resources/agent/agent.ts">ErrorCode</a></code>
 - <code><a href="./src/resources/agent/agent.ts">McpServerConfig</a></code>
 - <code><a href="./src/resources/agent/agent.ts">Scope</a></code>
 - <code><a href="./src/resources/agent/agent.ts">UserProfile</a></code>

src/client.ts

@@ -27,6 +27,8 @@ import {
   AgentSkill,
   AmbientAgentConfig,
   CloudEnvironmentConfig,
+  Error,
+  ErrorCode,
   McpServerConfig,
   Scope,
   UserProfile,
@@ -744,6 +746,8 @@ export declare namespace OzAPI {
     type AgentSkill as AgentSkill,
     type AmbientAgentConfig as AmbientAgentConfig,
     type CloudEnvironmentConfig as CloudEnvironmentConfig,
+    type Error as Error,
+    type ErrorCode as ErrorCode,
     type McpServerConfig as McpServerConfig,
     type Scope as Scope,
     type UserProfile as UserProfile,

src/resources/agent/agent.ts

@@ -262,6 +262,108 @@ export namespace CloudEnvironmentConfig {
   }
 }
 
+/**
+ * Error response following RFC 7807 (Problem Details for HTTP APIs). Includes
+ * backward-compatible extension members.
+ *
+ * The response uses the `application/problem+json` content type. Additional
+ * extension members (e.g., `auth_url`, `provider`) may be present depending on the
+ * error code.
+ */
+export interface Error {
+  /**
+   * Human-readable error message combining title and detail. Backward-compatible
+   * extension member for older clients.
+   */
+  error: string;
+
+  /**
+   * The HTTP status code for this occurrence of the problem (RFC 7807)
+   */
+  status: number;
+
+  /**
+   * A short, human-readable summary of the problem type (RFC 7807)
+   */
+  title: string;
+
+  /**
+   * A URI reference that identifies the problem type (RFC 7807). Format:
+   * `https://docs.warp.dev/agent-platform/troubleshooting/errors/{error_code}` See
+   * PlatformErrorCode for the list of possible error codes.
+   */
+  type: string;
+
+  /**
+   * A human-readable explanation specific to this occurrence of the problem
+   * (RFC 7807)
+   */
+  detail?: string;
+
+  /**
+   * The request path that generated this error (RFC 7807)
+   */
+  instance?: string;
+
+  /**
+   * Whether the request can be retried. When true, the error is transient and the
+   * request may be retried. When false, retrying without addressing the underlying
+   * cause will not succeed.
+   */
+  retryable?: boolean;
+
+  /**
+   * OpenTelemetry trace ID for debugging and support requests
+   */
+  trace_id?: 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)
+ */
+export type ErrorCode =
+  | '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';
+
 /**
  * Configuration for an MCP server. Must have exactly one of: warp_id, command, or
  * url.
@@ -543,6 +645,8 @@ export declare namespace Agent {
     type AgentSkill as AgentSkill,
     type AmbientAgentConfig as AmbientAgentConfig,
     type CloudEnvironmentConfig as CloudEnvironmentConfig,
+    type Error as Error,
+    type ErrorCode as ErrorCode,
     type McpServerConfig as McpServerConfig,
     type Scope as Scope,
     type UserProfile as UserProfile,

src/resources/agent/index.ts

@@ -5,6 +5,8 @@ export {
   type AgentSkill,
   type AmbientAgentConfig,
   type CloudEnvironmentConfig,
+  type Error,
+  type ErrorCode,
   type McpServerConfig,
   type Scope,
   type UserProfile,

src/resources/agent/runs.ts

@@ -383,23 +383,7 @@ export namespace RunItem {
      * - `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';
+    error_code?: AgentAPI.ErrorCode;
 
     /**
      * Whether the error is transient and the client may retry by submitting a new run.

src/resources/index.ts

@@ -5,6 +5,8 @@ export {
   type AgentSkill,
   type AmbientAgentConfig,
   type CloudEnvironmentConfig,
+  type Error,
+  type ErrorCode,
   type McpServerConfig,
   type Scope,
   type UserProfile,